Intervals Icu MCP
Read and write Intervals.icu training data: activities, wellness, calendar and workouts
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 5.9.1
- Listing updated
- today
Similar MCP servers
About Intervals Icu MCP
Intervals Icu MCP is an open-source MCP server for health and science. It runs locally on your machine and is started by your AI client.
For athletes who track training in Intervals.icu, this local server lets an assistant read and edit that data. The README counts 73 tools across activities, activity analysis, activity messages, athlete profile, wellness, calendar events, performance curves, the workout library, gear, sport settings and custom items, plus four resources and nine prompts for things like training analysis, recovery checks and weekly planning.
Starter prompts include asking whether you are overtraining by checking CTL, ATL and TSB, reviewing HRV and sleep trends, finding your 20-minute power and FTP, and creating a sweet spot cycling workout for tomorrow. Because it can write as well as read, activities can be updated or deleted, so access should be treated carefully.
It runs over stdio, started with uvx, from source or in Docker, and needs your Intervals.icu API key and athlete ID. It is an independent continuation of an MIT-licensed project, with bug fixes and new features.
Install
Run in a terminal
claude 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-mcpAdd to claude_desktop_config.json
{
"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>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"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>"
}
}
}
}Add to .vscode/mcp.json
{
"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>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"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>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"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>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
INTERVALS_ICU_API_KEYYour Intervals.icu API key (from Settings → Developer)RequiredINTERVALS_ICU_ATHLETE_IDYour Intervals.icu athlete ID (e.g. i12345)Required
What it does
- 73 tools
- Covers activities, wellness, calendar, gear and workouts.
- Activity analysis
- Streams, intervals, best efforts and histograms.
- Wellness tracking
- Reads HRV, sleep and recovery metrics.
- Workout planning
- Creates workouts in the library and calendar.
- Prompts and resources
- Includes nine prompt templates and four resources.
Good for
- Check training load for overtraining signs
- Review recovery over the past week
- Find power curve numbers such as FTP
- Schedule a structured workout
Pricing
Open source
MIT-licensed per README badge
Intervals Icu MCP FAQ
What credentials are needed?
An Intervals.icu API key and athlete ID.
Can it change my data?
Yes, it can update and delete activities and edit the calendar.
How do I run it?
Use uvx, Docker or a source checkout.
Does it work with ChatGPT?
Only through a tunnelled HTTP setup the README says is not yet verified end to end.
Is Intervals Icu MCP free?
Yes. Intervals Icu MCP is open source, so you can use and self-host it for free.
How do I add Intervals Icu MCP to Claude Code?
Run this command in your terminal: claude 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-mcp
What are the best alternatives to Intervals Icu MCP?
The closest alternatives to Intervals Icu MCP are Tooluniverse, Oya Browser, BasalFit, Ebi Ols and Clinicaltables.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

