Server endpoint
The same URL for every client. Copy it now — each setup path below asks for it.
https://mcp.aicalpal.com
Before you start
Two things worth knowing — both take under a minute and save a lot of confusion later.
Enable location so logging uses your timezone
CalPal saves sleep, meals and exercise in your local time. If your assistant doesn't know where you are, entries can land hours off — or on the wrong day. Turn on location access for your AI app, or tell the assistant your timezone once ("I'm in Europe/Berlin").
Running the tools requires CalPal Pro
Connecting works on any plan, but the tools need an active Pro subscription, purchased in the CalPal app. Get the app →
Choose your client
Claude connects in one click over OAuth. Every other client authenticates with a Bearer header.
-
Add a custom connector
In Claude, open Settings → Connectors → Add custom connector. Name it CalPal and paste the server URL above.
-
Paste the OAuth client ID
Open Advanced settings and paste this client ID — it is required. Leave the client secret blank.
c0a57623-8b3a-4cac-a32f-b2d115065a1aPublic value, registered for Claude only.
-
Connect and 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.
-
Set your timezone
Turn on location access for Claude, or tell it your timezone once — otherwise entries can land on the wrong day.
-
Get your access token
Cursor authenticates with a Bearer token — the OAuth client ID is registered for Claude only, so it will not work here. Sign in to generate a personal token.
Sign in & get token -
Add CalPal to mcp.json
Cursor → Settings → Tools & Integrations → New MCP Server, or edit ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):
{ "mcpServers": { "calpal-ai": { "url": "https://mcp.aicalpal.com", "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.
-
Enable the server
Toggle CalPal on under Customize — the tools appear under Available Tools. Cursor asks before each write tool runs.
-
Set your timezone
Tell the agent your timezone once (e.g. "I'm in Europe/Berlin") — otherwise entries can land on the wrong day.
-
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 -
Add the Authorization header
Point the client at https://mcp.aicalpal.com over streamable HTTP and send Authorization: Bearer <token>. In VS Code run MCP: Open User Configuration, or edit .vscode/mcp.json:
{ "servers": { "calpal-ai": { "type": "http", "url": "https://mcp.aicalpal.com", "headers": { "Authorization": "Bearer <YOUR_TOKEN>" } } } }Any other MCP client needs the same three pieces — the URL, streamable HTTP transport, and the Authorization header.
-
Reload the server
Restart or reconnect the MCP server in your client — the CalPal tools load automatically, each marked read-only or write, which your client uses to decide when to ask first.
-
Set your timezone
Tell the assistant your timezone once (e.g. "I'm in Europe/Berlin") — otherwise entries can land on the wrong day.
Keep your token private
It is long-lived and grants the same access as signing in. Never commit it — use an environment variable. If the connection stops working, sign in again for a new one. Changing your CalPal password ends every token at once.
Manage & revoke access
Access is yours to withdraw at any time, from either end of the connection.
From CalPal
Review the apps connected through OAuth, such as Claude, and revoke the ones you no longer use. A token from the sign-in page is not listed there; changing your CalPal password ends it.
From your client
Remove the CalPal connector, or delete the Authorization header from your config file. This disconnects that client only — a copy of the token kept elsewhere still works.
What you're granting
33 tools, scoped only to your account. Each is marked read-only or write, which your client uses to decide when to ask for your approval.