Connect CalPal to your AI assistant

Choose your client

1. 1

   Add a custom connector

   Claude → Settings → Connectors → Add custom connector. Name it CalPal and paste the server URL above.

2. 2

   Paste the OAuth client ID

   Open Advanced settings and paste this client ID — it's required. Leave the client secret blank.

   OAuth client ID · public · Claude only

   c0a57623-8b3a-4cac-a32f-b2d115065a1a Copy
3. 3

   Connect & sign in

   Click Add → Connect, sign in to CalPal and approve access. The tools appear automatically and your access refreshes on its own — nothing to copy or rotate.

4. 4

   Set your timezone

   Turn on location access for Claude, or tell it your timezone once — otherwise entries can land on the wrong day.

1. 1

   Get your access token

   Cursor authenticates with a Bearer token — the OAuth client ID is registered for Claude only, so it won't work here. Sign in to generate a personal token.

   Sign in & get token →
2. 2

   Add CalPal to mcp.json

   Cursor → Settings → Tools & Integrations → New MCP Server, or edit ~/.cursor/mcp.json (all projects) / .cursor/mcp.json (this project):

   Copy

   {
     "mcpServers": {
       "calpal-ai": {
         "url": "https://mcp.calpalai.app",
         "headers": {
           "Authorization": "Bearer <YOUR_TOKEN>"
         }
       }
     }
   }

   To keep the token out of the file, export CALPAL_TOKEN in your shell profile and use "Bearer ${env:CALPAL_TOKEN}" — Cursor interpolates headers values.

3. 3

   Enable the server

   Toggle CalPal on under Customize — the tools appear under Available Tools. Cursor asks before each write tool runs.

4. 4

   Set your timezone

   Tell the agent your timezone once (e.g. "I'm in Europe/Berlin") — otherwise entries can land on the wrong day.

1. 1

   Get your access token

   VS Code, Zed, custom scripts — every client other than Claude authenticates with a Bearer token. Sign in to generate one.

   Sign in & get token →
2. 2

   Add the Authorization header

   Point the client at https://mcp.calpalai.app over streamable HTTP and send Authorization: Bearer <token>. In VS Code run MCP: Open User Configuration, or edit .vscode/mcp.json:

   Copy

   {
     "servers": {
       "calpal-ai": {
         "type": "http",
         "url": "https://mcp.calpalai.app",
         "headers": {
           "Authorization": "Bearer <YOUR_TOKEN>"
         }
       }
     }
   }

   Any other MCP client needs the same three pieces — the URL, streamable HTTP transport, and the Authorization header.

3. 3

   Reload the server

   Restart or reconnect the MCP server in your client — the CalPal tools load automatically. Read tools run without a prompt; write tools always ask first.

4. 4

   Set your timezone

   Tell the assistant your timezone once (e.g. "I'm in Europe/Berlin") — otherwise entries can land on the wrong day.