Back to overview

Setup guide

Connect athletedata to Claude

Add athletedata as a custom connector in Claude. Works on both claude.ai (web) and Claude Desktop. Takes about a minute.

Heads up: custom connectors require a paid Claude plan (Pro or Max). They are not available on the free tier.
1

Open Claude's connector settings

Go to claude.ai/settings/connectors. If you're on Claude Desktop, the same page lives under Settings → Connectors.

2

Click 'Add custom connector'

Scroll past the built-in connectors (GitHub, Google Drive, Gmail, etc.) until you see the Add custom connector button. Click it.

Claude connectors page with Add custom connector button
3

Paste your athletedata MCP URL

A dialog opens asking for a name and a URL.

  • Name: athletedata
  • URL: grab it from your dashboard using the Copy MCP URL button. It looks like https://mcp.athletedata.health/mcp?apiKey=sk_soma_...
Claude Add custom connector dialog with athletedata URL filled in
4

Click 'Add' and start chatting

Hit Add. The connector should appear in your list as Connected. Open a new chat and ask anything about your training - the tools will be called automatically.

Try something like:

What was my training load over the last 4 weeks, and how does my HRV trend compare?

Reference: JSON config

If you're editing claude_desktop_config.json directly (advanced), here's the equivalent config:

{
  "mcpServers": {
    "athletedata": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.athletedata.health/mcp?apiKey=YOUR_API_KEY"
      ]
    }
  }
}

Not working?