All posts

Connect Claude to Atomic Metrix with MCP

5 min read

Atomic Metrix MCP lets Claude ask for your authorized training data: rides, power analysis, readiness, plans, and scheduled workouts. You do not paste passwords into Claude. You connect once, approve OAuth, and Claude can call Atomic Metrix tools when you ask.

Use Claude Desktop if you prefer clicking through settings. Use the CLI if you are comfortable running one terminal command.

Option A: Claude Desktop connector

This is the easiest path for most users. Claude Desktop has a custom connector flow where you paste the Atomic Metrix MCP URL.

1

Open Customize

In Claude Desktop, open the left sidebar and choose Customize.

Chat
New chat
Projects
Artifacts
Customize
2

Open Connectors

Choose Connectors from the Customize screen.

Customize
+
Skills
Connectors
3

Add a custom connector

Click the plus button and choose Add custom connector.

Connectors

+
Browse connectors
Add custom connector
4

Paste the Atomic Metrix MCP URL

Use Atomic Metrix as the name, then paste the MCP URL and click Add.

Add custom connector

BETA
Name
Atomic Metrix
URL
https://www.atomicmetrix.com/mcp
CancelAdd

After you click Add, Claude will prompt you to authenticate. Complete the browser login with your Atomic Metrix account and approve access.

Option B: one-command CLI setup

If you use Claude from the terminal or prefer editing local client configuration automatically, run this command:

$ npx @atomicmetrix/mcp@latest setup claude

The CLI writes the Atomic Metrix MCP server entry to ~/.claude.json. Restart Claude, then complete the browser OAuth login when Claude asks you to authorize Atomic Metrix.

How to verify it worked

Open a new Claude chat and ask one of these prompts. Claude should show Atomic Metrix tool calls before answering.

Use Atomic Metrix to summarize my current training status.
Use Atomic Metrix to analyze my latest ride.
Use Atomic Metrix to show my power curve.

Troubleshooting

  • Use the exact connector URL: https://www.atomicmetrix.com/mcp
  • If you used CLI setup, restart Claude after the command finishes.
  • Complete the browser OAuth login when prompted. Without OAuth, Claude can see the connector but cannot read your data.
  • If tools do not appear, remove duplicate Atomic Metrix connectors and add it again.
  • If Claude connects but has no ride data, connect Strava or Intervals.icu inside Atomic Metrix first.
Claude Desktop path: custom connector UI with the MCP URL.
CLI path: writes to local Claude config and requires restart.
Both paths use the same Atomic Metrix OAuth permissions and tools.