Skip to content
MCP server

Intervals Icu MCP

Read and write Intervals.icu training data: activities, wellness, calendar and workouts

Runs locallyStatus and history
Install
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-mcp

Add 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)Required
  • INTERVALS_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.

How AIPoweredBot checks servers