← Integrations
CD

Claude Desktop

Add CalendarMCP to Claude Desktop so Claude can read and manage your Google Calendar directly in chat. Takes about 2 minutes.

Before you start

  • 1.Get your API key. Go to calendarmcp.ai/app, connect your Google Calendar, and copy the API key from the dashboard.
  • 2.Claude Desktop 0.10+. Open Claude Desktop and check Help → About. MCP support requires version 0.10 or later.

Setup steps

Step 1: Open Claude Desktop config

Open your Claude Desktop configuration file. The path depends on your OS:

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

If the file doesn't exist, create it. If it does, you'll merge in the new key.

Step 2: Add the MCP server config

Paste the following into your config file. Replace cal_your_api_key with your actual key.

{
  "mcpServers": {
    "calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-fetch",
        "--url", "https://calendarmcp.ai/api/mcp",
        "--header", "Authorization: Bearer cal_your_api_key"
      ]
    }
  }
}

If you already have other MCP servers in mcpServers, add "calendar": ... alongside them.

Step 3: Restart Claude Desktop

Quit Claude Desktop completely (don't just close the window) and reopen it. MCP servers are loaded at startup.

Step 4: Verify it's connected

In Claude, click the tools icon (hammer) in the bottom toolbar. You should see calendar listed with 10 tools. If not, check the config file for JSON syntax errors.

Test it

Try one of these prompts in Claude Desktop:

  • What's on my calendar today?
  • Find 30 minutes free tomorrow afternoon.
  • Create an event called "Sprint planning" next Monday at 10am.

Available tools

After connecting, Claude Desktop has access to all 10 CalendarMCP tools:

list_events
get_event
create_event
update_event
delete_event
quick_add_event
list_calendars
find_free_time
manage_attendees
batch_update_events
Full tool documentation →

Troubleshooting

MCP server not showing in Claude

Check the JSON syntax in your config file. A trailing comma or missing bracket will silently prevent the server from loading. Use a JSON validator if unsure.

Authentication error

Make sure your API key starts with cal_. Copy it fresh from the dashboard. Don't retype it.

No calendars returned

Your Google account may not have any calendars with events. Try "List my calendars" to see what's connected.