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

Set up in 4 steps

  1. 1

    Add a custom connector

    Claude → Settings → Connectors → Add custom connector.

  2. 2

    Paste the server URL

    Use https://mcp.calpalai.app. If asked under “Advanced”, paste the Client ID above (no secret).

  3. 3

    Sign in & approve

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

  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.

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

19 tools, scoped only to your account.

View all 19 tools
manage_user_profilemanage_user_bio manage_user_preferencesmanage_user_goals get_user_dataget_user_subscription manage_weightmanage_water manage_sleepmanage_mood manage_exercisemanage_notes search_foodmanage_meal_logs manage_custom_foodsbrowse_nutrients browse_serving_unitssearch_exercise_types browse_recipes
🔐 OAuth 2.1 · PKCE 🪪 ES256 / JWKS 🚫 Revoke anytime