Connect CalPal to your AI assistant

Choose how your client connects to the CalPal MCP server.

Important — enable location so logging uses your timezone

CalPal saves sleep, meals, exercise and more in your local time. If your AI assistant doesn't know where you are, entries can be logged in the wrong timezone — hours off, or even on the wrong day. Before you start logging, turn on location access for your AI app, or just tell the assistant your timezone once (e.g. "I'm in Europe/Berlin").

Secure one-click OAuth 2.1 · no tokens to copy
https://mcp.calpalai.app
c0a57623-8b3a-4cac-a32f-b2d115065a1a

Choose your client

  1. 1

    Copy the CalPal server URL

    Copy https://mcp.calpalai.app from above — you'll paste it in the next step.

  2. 2

    Add a custom connector

    Claude → Settings → Connectors → Add custom connector. Name it CalPal and paste the URL. Open Advanced settings and paste the OAuth Client ID above (required) — leave the client secret blank.

  3. 3

    Connect & sign in

    Click Add → Connect, sign in to CalPal and approve access. Tools appear automatically — tokens refresh on their own.

  1. 1

    Turn on Developer mode

    ChatGPT → Settings → Apps & Connectors → Advanced settings → enable Developer mode, then click Create.

  2. 2

    Create the CalPal app

    Name it CalPal and paste https://mcp.calpalai.app as the MCP server URL. Choose OAuth for authentication, open Advanced and paste the OAuth Client ID above (required).

  3. 3

    Connect & sign in

    Click Create, sign in to CalPal and approve. Call it with @CalPal in any chat.

  1. 1

    Copy the CalPal server URL

    Copy https://mcp.calpalai.app from above.

  2. 2

    Add a new MCP server

    Cursor → Settings → Tools & Integrations → New MCP Server (or edit ~/.cursor/mcp.json). Add CalPal with the URL. When prompted for Advanced OAuth details, paste the OAuth Client ID above (required).

  3. 3

    Connect & sign in

    Cursor opens the CalPal sign-in — approve access. The tools load automatically and tokens refresh on their own.

  1. 1

    Add a custom connector

    In any OAuth 2.1-capable MCP client, add a new custom connector pointing at https://mcp.calpalai.app.

  2. 2

    Set OAuth & the Client ID

    Choose OAuth 2.1 as the auth method. In the client's Advanced settings, paste the OAuth Client ID above (required) — no client secret is needed.

  3. 3

    Connect & sign in

    Complete the CalPal sign-in and approve. Tools load automatically and tokens refresh on their own.

Last step — enable location for accurate logging

So entries save in your timezone, let your AI app share your location — or tell it your timezone once (e.g. "I'm in Europe/Berlin"). Without it, sleep, meals & workouts can be logged hours off, or on the wrong day.

For clients without OAuth — e.g. VS Code, Zed, custom scripts

Set up in 4 steps

  1. 1

    Get your access token

    Sign in to CalPal to generate a personal Bearer token.

    Sign in & get token →
  2. 2

    Add the server to your client config

    Point your client at https://mcp.calpalai.app and send your token in the Authorization header. Example mcp.json (VS Code & compatible): 

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

    Reload your client

    Restart or reconnect the MCP server in your client — the CalPal tools appear automatically.

  4. 4

    Enable location for accurate logging

    So entries save in your timezone, let your AI app share your location — or tell it your timezone once (e.g. "I'm in Europe/Berlin"). Without it, sleep, meals & workouts can be logged hours off, or on the wrong day.

Heads up: the token is long-lived and the server refreshes your access automatically — keep it private. If the connection ever stops working, sign in again for a new one. For a fully hands-off setup, use OAuth 2.1 instead.

Manage & revoke access

What you're granting

31 tools (19 read-only, 12 write), scoped only to your account. Read tools run without a prompt; write tools always ask you first.

View all 31 tools
search_foodlist_custom_foods list_meal_logsbrowse_nutrients browse_serving_unitslist_weight list_waterlist_sleep list_moodlist_exercise list_notessearch_exercise_types get_user_profileget_user_bio get_user_preferencesget_user_goals get_user_dataget_user_subscription browse_recipesmanage_meal_logs manage_custom_foodsmanage_weight manage_watermanage_sleep manage_moodmanage_exercise manage_notesmanage_user_profile manage_user_biomanage_user_preferences manage_user_goals
🔐 OAuth 2.1 · PKCE 🪪 ES256 / JWKS 🚫 Revoke anytime