Set Up MCP (Claude)

Connect Synced to Claude via the Model Context Protocol. Once configured, you can ask Claude to schedule meetings, check availability, and manage contacts.

Prerequisites

A Synced account with a connected calendar
An API key (see Generate API Keys)
Claude Desktop or a Claude.ai Pro/Team subscription

Option 1: Claude Desktop (stdio)

Claude Desktop uses the stdio transport. Add Synced to your MCP config file:

claude_desktop_config.json

{
  "mcpServers": {
    "synced-calendar": {
      "command": "npx",
      "args": ["-y", "@synced/mcp-server"],
      "env": {
        "SYNCED_API_KEY": "your-api-key-here"
      }
    }
  }
}

Config file location

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Option 2: Claude.ai Web (SSE)

Claude.ai uses Server-Sent Events (SSE) transport. Add this MCP server URL in your Claude.ai settings:

https://wkpulvilwaqkoqfuztgh.supabase.co/functions/v1/mcp?api_key=your-api-key-here

API key in URL

Claude.ai passes the API key as a URL parameter for SSE connections. This is safe because the connection is encrypted via HTTPS, but avoid sharing this URL publicly.

Verify the Connection

After configuring, try asking Claude:

"What meetings do I have this week?"
"Show me my availability for tomorrow"
"Schedule a 30-minute call with sarah@acme.com next Tuesday"

Claude will use Synced's MCP tools to check your calendar and respond with real data.

Available MCP Tools

Synced provides 6 MCP tools. See the MCP Tools Reference for full schemas and examples.

get_meetings — List upcoming, past, or draft meetings
get_contacts — List trusted contacts
get_availability — Check free/busy schedule
schedule_meeting — Create a meeting with calendar invites
get_recommended_slots — AI-powered slot recommendations
natural_language_schedule — Parse natural language requests