Connect CalPal to your AI assistant

Server endpoint

The same URL for every client. Copy it now — each setup path below asks for it.

https://mcp.calpalai.app

Transport Streamable HTTP

Authentication OAuth 2.1 or Bearer

Tools 20 read · 12 write

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-b2d115065a1a

Public 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
2
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.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.
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
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:
```
{
  "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.
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.
Set your timezone

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

Manage & revoke access

Access is yours to withdraw at any time, from either end of the connection.

From CalPal

Review every connected app and revoke the ones you no longer use.

Manage connected apps →

From your client

Remove the CalPal connector, or delete the Authorization header from your config file.

What you're granting

32 tools, scoped only to your account. Read tools run without a prompt; write tools always ask you first.

20 read-only 12 write — always confirmed

View all 32 tools

search_food list_custom_foods list_meal_logs get_daily_calorie_summary browse_nutrients browse_serving_units list_weight list_water list_sleep list_mood list_exercise list_notes search_exercise_types get_user_profile get_user_bio get_user_preferences get_user_goals get_user_data get_user_subscription browse_recipes manage_meal_logs manage_custom_foods manage_weight manage_water manage_sleep manage_mood manage_exercise manage_notes manage_user_profile manage_user_bio manage_user_preferences manage_user_goals

Server endpoint

Before you start

Choose your client

Add a custom connector

Paste the OAuth client ID

Connect and sign in

Set your timezone

Get your access token

Add CalPal to mcp.json

Enable the server

Set your timezone

Get your access token

Add the Authorization header

Reload the server

Set your timezone

Manage & revoke access

What you're granting