MCP Server

Give your AI agent hands-on control of calsync. The /api/mcp endpoint speaks the Model Context Protocol over streamable HTTP — compatible with Claude Desktop, Cursor, and any MCP client.

Connect any MCP client

Point your agent at https://calsync.cc/api/mcp with an API key. calsync exposes tools to create and manage calendars, events, ICS feeds and subscriber stats — no dashboard required.

API key

Your key is only used in this browser to call the endpoint — never stored.

Claude Desktop

claude_desktop_config.json

{
  "mcpServers": {
    "calsync": {
      "url": "https://calsync.cc/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_CS_LIVE_KEY"
      }
    }
  }
}

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "calsync": {
      "url": "https://calsync.cc/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_CS_LIVE_KEY"
      }
    }
  }
}

Generic streamable HTTP (curl)

curl

curl https://calsync.cc/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer YOUR_CS_LIVE_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"calsync","version":"1.0"}}}'

Tools exposed to agents

list_calendarsList calendars accessible to the key

get_calendarFetch a calendar by id or slug

create_calendarCreate a calendar (personal key)

update_calendarUpdate title, slug, description or visibility

delete_calendarDelete a calendar and its events

list_eventsList events on a calendar

get_eventFetch a single event by id

create_eventCreate an event

update_eventUpdate an event's fields

delete_eventDelete an event

get_ics_feedReturn the public ICS URL and events for a calendar

get_subscriber_statsSubscriber counts for all accessible calendars

Each tool requires the matching scope on the API key (e.g. events:writefor create/update/delete). Requests count against the key's plan usage like REST calls.