← Integrations
CC

Claude Code

Claude Code is Anthropic's terminal-based agentic coding tool. Adding CalendarMCP takes a single command and lets Claude Code manage your calendar as part of coding workflows.

Before you start

Get your API key from calendarmcp.ai/app. Connect your Google Calendar and copy the key from the dashboard. It starts with cal_.

Setup steps

Step 1: Add the MCP server

Run this command in your terminal. Replace the API key with yours:

claude mcp add --transport http calendar https://calendarmcp.ai/api/mcp \
  --header "Authorization: Bearer cal_your_api_key"

This adds the server to your global Claude Code config at ~/.claude/mcp_servers.json.

Step 2: Verify

List your configured servers to confirm:

claude mcp list

You should see calendar with the CalendarMCP URL.

Step 3: Use it

Claude Code can now access your calendar in any session. No flags needed. It's available globally.

claude "Check my calendar for tomorrow and block focus time"

Per-project config (optional)

To scope CalendarMCP to one project, add a .mcp.json file at your project root instead of using the global flag:

{
  "mcpServers": {
    "calendar": {
      "url": "https://calendarmcp.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer cal_your_api_key"
      }
    }
  }
}

Claude Code picks up .mcp.json automatically when you run it from that directory.

Useful for coding workflows

Sprint planning
"Create calendar events for this week's sprint tasks from JIRA"
Release scheduling
"Schedule a release review meeting for Thursday at 2pm with the team"
Meeting prep
"What meetings do I have tomorrow? Summarize the context from their titles"
Time blocking
"Block 3 hours tomorrow morning for deep work on the auth refactor"