intervals-icu-mcp — Claude Code MCP server for training data
Connects an AI client to Intervals.icu data on activities, wellness, gear, and workouts. Use it to review training and plan a week.
claude mcp add intervals-icu-mcp -e INTERVALS_ICU_API_KEY=<INTERVALS_ICU_API_KEY> -e INTERVALS_ICU_ATHLETE_ID=<INTERVALS_ICU_ATHLETE_ID> -- uvx intervals-icu-mcpWhat intervals-icu-mcp does
This MCP server gives an AI client access to Intervals.icu, with tools for reading and changing activity, wellness, calendar, gear, and workout data. It also includes athlete-profile and activity-analysis tools, resources covering workout syntax and related schemas, plus prompts for training analysis, recovery checks, and weekly planning.
The server communicates over stdio. Setup requires an Intervals.icu API key and athlete ID; the recommended launch uses uvx, which comes with uv. Without those credentials, it cannot access the account's training data. You can also run it from a source checkout or with Docker.
What it helps with
- review recent Intervals.icu activities
- inspect performance data for an activity
- check wellness metrics
- plan a week of training
- look up calendar and gear details
Example prompts for the agent
- Show my recent activities from Intervals.icu.
- Analyze this activity using my athlete data.
- Help me plan a training week based on my wellness information.
How to install intervals-icu-mcp
Platform CLI
claude mcp add intervals-icu-mcp -e INTERVALS_ICU_API_KEY=<INTERVALS_ICU_API_KEY> -e INTERVALS_ICU_ATHLETE_ID=<INTERVALS_ICU_ATHLETE_ID> -- uvx intervals-icu-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from intervals-icu-mcp <command>
Platform CLI
codex mcp add intervals-icu-mcp --env INTERVALS_ICU_API_KEY=<INTERVALS_ICU_API_KEY> --env INTERVALS_ICU_ATHLETE_ID=<INTERVALS_ICU_ATHLETE_ID> -- uvx intervals-icu-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from intervals-icu-mcp <command>
Config file
{
"mcpServers": {
"intervals-icu-mcp": {
"command": "uvx",
"args": [
"intervals-icu-mcp"
],
"env": {
"INTERVALS_ICU_API_KEY": "<INTERVALS_ICU_API_KEY>",
"INTERVALS_ICU_ATHLETE_ID": "<INTERVALS_ICU_ATHLETE_ID>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from intervals-icu-mcp <command>
Config file
{
"servers": {
"intervals-icu-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"intervals-icu-mcp"
],
"env": {
"INTERVALS_ICU_API_KEY": "<INTERVALS_ICU_API_KEY>",
"INTERVALS_ICU_ATHLETE_ID": "<INTERVALS_ICU_ATHLETE_ID>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from intervals-icu-mcp <command>
Platform CLI
gemini mcp add -e INTERVALS_ICU_API_KEY=<INTERVALS_ICU_API_KEY> -e INTERVALS_ICU_ATHLETE_ID=<INTERVALS_ICU_ATHLETE_ID> intervals-icu-mcp uvx intervals-icu-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from intervals-icu-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about intervals-icu-mcp
How do I install intervals-icu-mcp in Claude Code?
Run `claude mcp add intervals-icu-mcp -e INTERVALS_ICU_API_KEY=<INTERVALS_ICU_API_KEY> -e INTERVALS_ICU_ATHLETE_ID=<INTERVALS_ICU_ATHLETE_ID> -- uvx intervals-icu-mcp with your API key and athlete ID. The recommended setup launches it with uvx`.
What does intervals-icu-mcp do?
It connects an AI client to Intervals.icu data, including activities, wellness, calendar, gear, and workouts. The server also provides analysis tools and prompts for training and recovery.
What do I need to run intervals-icu-mcp?
You need an Intervals.icu API key and athlete ID. For the recommended launch method, install uv, which includes uvx.
