intervals-icu-mcp: Intervals.icu training data in an agent

Install

Works in

• Claude Desktop
• Claude Code
• Cursor
• SourceCraft
• Koda
• Coddy

Manual install

{"mcpServers":{"intervals-icu":{"command":"uvx","args":["intervals-icu-mcp"],"env":{"INTERVALS_ICU_API_KEY":"your-api-key-here","INTERVALS_ICU_ATHLETE_ID":"i123456"}}}}

What it does

The server connects an agent to Intervals.icu, a service for analysing sports training. It has 73 tools, 4 resources and 9 prompt templates. The tools cover activities and their analysis, activity notes, the athlete profile, wellness, calendar and events, performance curves, the workout library, gear and sport settings. The agent answers questions like "show my activities from the last 7 days" and builds structured workouts, for example an interval bike session for tomorrow. Data can be read and edited with ordinary requests, and bulk operations exist in the calendar and the library. Destructive tools are gated by `INTERVALS_ICU_DELETE_MODE` with the values `safe`, `full` and `none`; the default is `safe`. It is a server-side check: unregistered tools cannot be called by the model. The server uses stdio, and HTTP and SSE modes exist for remote setups. The project continues eddmann/intervals-icu-mcp with fixes and new features.

Who it is for. Athletes and coaches on Intervals.icu who want to review training, wellness and a season plan by talking to Claude, ChatGPT or Cursor.

Example request

Show my activities from the last seven days, estimate total load and draft an interval workout for tomorrow, but do not put it in the calendar yet.

MCP

Transport

stdio

Authentication

API key

Limitations

It needs an Intervals.icu account, an API key and an athlete ID like `i123456`. The key is created in settings under Developer. `uv` runs it: `uvx` downloads and caches the package itself.

The server reads and writes: the agent can update and delete activities, events and workouts. The default delete mode `safe` restricts dangerous tools, and `full` opens all. Health and training data count as sensitive.

The project is independent: the author states it continues someone else's repository and is not an official Intervals.icu product.

How to disable. Remove the `intervals-icu` entry from the client configuration and revoke the API key in Intervals.icu settings under Developer.

README in short

The README opens with a Claude Desktop quick start, then explains creating the API key, installing through uvx, from source and in Docker, client configs, example prompts and a summary of tools by category. Separate sections cover the delete safety mode and remote deployment over HTTP and SSE.