Log inSubmit server
Intervals Icu MCP logo

Intervals Icu MCP

Connects MCP-compatible AI clients to Intervals.icu training, wellness, activity, and performance data.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Intervals Icu MCP

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "intervals-icu-mcp": {
      "command": "uvx",
      "args": [
        "intervals-icu-mcp"
      ],
      "env": {
        "INTERVALS_ICU_API_KEY": "YOUR_VALUE_HERE",
        "INTERVALS_ICU_ATHLETE_ID": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 67 tools correctly (7d ago).

Overview

The intervals-icu-mcp MCP server connects MCP-compatible AI clients to Intervals.icu through its API. It exposes tools for activities, wellness, athlete data, calendars, performance analysis, workouts, gear, and related records, along with resources and prompt templates. Run it over stdio with uvx, from source, or in Docker, then provide an Intervals.icu API key and athlete ID. Reach for it when you want to inspect or update training data through natural-language requests in a supported client.

Use cases

  • Review recent training activities
  • Analyze recovery and wellness trends
  • Inspect CTL, ATL, and TSB
  • Create a cycling workout
  • Check power and FTP metrics

Key features

  • Query and manage Intervals.icu activities
  • Analyze streams, intervals, and best efforts
  • Read wellness and athlete data
  • Access calendars, workouts, gear, and performance curves
  • Expose MCP resources and prompt templates

Tools67

What Intervals Icu MCP lets your agent do. Expand a tool for its parameters.

Verified live~19.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

8/8 checks healthy over the last 40d

What it can do

From the 67 tools this server returned when we ran it; 67 declare their own safety hints.

Can delete or modify data · 9Makes network requests · 67Read-only tools · 58
Network at startup2 connections
Files written at startup30

Observed 2026-10-15 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 14d ago via OSV.dev · intervals-icu-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars103Stargazers on the source repository.
Last commit4d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed67Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Intervals Icu MCP works

What intervals-icu-mcp does

The intervals-icu-mcp MCP server gives an AI client access to an Intervals.icu athlete account. Its coverage includes activity records and analysis, wellness measurements, athlete profile data, events and calendar items, performance curves, workout-library entries, gear, sport settings, and custom items.

It also lists four MCP resources for athlete profile information, workout syntax, event categories, and custom-item schemas. Nine prompt templates cover areas such as training analysis, recovery checks, and weekly planning.

The documentation contains inconsistent totals: the overview says 69 tools, while the available-tools table says 68. The category descriptions and capabilities above are supported without relying on that total.

How it works

The intervals-icu-mcp MCP server communicates with clients over MCP stdio. A client launches the package, and the server uses the supplied Intervals.icu credentials to access the athlete account. Requests can be written in natural language, such as asking for recent activities, recovery trends, training-load values, or a performance metric.

The recommended launcher is uvx intervals-icu-mcp, which retrieves and caches the package and its Python environment through uv. The project also supports running from a local checkout and running in Docker.

Setup and configuration

Create an Intervals.icu API key under Settings → Developer → Create API Key, and copy the athlete ID from the profile URL. The athlete ID uses a format such as i123456.

Set these environment variables for the recommended configuration:

  • INTERVALS_ICU_API_KEY: the API key created in Intervals.icu.
  • INTERVALS_ICU_ATHLETE_ID: the target athlete identifier.

For Claude Desktop, add an MCP entry whose command is uvx, whose argument is intervals-icu-mcp, and whose environment contains both values. Cursor uses a comparable mcp.json entry. Claude Code can register the same command with its claude mcp add command. Source users can clone the repository, run uv sync, and use the included authentication setup command. Docker users can build the image and mount an environment file.

Tools and capabilities

The intervals-icu-mcp MCP server supports these documented areas:

  • Activities: retrieve, search, modify, remove, or download activity data.
  • Activity analysis: inspect streams, intervals, best efforts, and histograms.
  • Activity messages: read and post notes, comments, and coach feedback.
  • Athlete, wellness, events, performance curves, workout library, gear, sport settings, and custom items.
  • MCP resources for profile data, workout syntax, event categories, and custom-item schemas.
  • MCP prompts for training analysis, recovery review, and planning workflows.

The README’s example requests include showing activities from a selected period, reviewing CTL, ATL, and TSB, examining HRV and sleep trends, creating a sweet-spot cycling workout, and checking 20-minute power or FTP.

Limitations and notes

Credentials are required before the server can access account data.

The server is intended for MCP-compatible clients. The README provides configurations for Claude Desktop, Claude Code, and Cursor, and separately documents ChatGPT connectivity. It does not describe client-specific setup for other applications.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Intervals Icu MCP

intervals-icu-mcp is an MCP server that connects AI clients to Intervals.icu through its API. Its main tools cover activities, activity analysis, wellness, athlete profiles, events, performance curves, workouts, gear, and custom items, with additional MCP resources and prompt templates for training, recovery, and planning.

Install uv and launch it with `uvx intervals-icu-mcp` from your MCP client configuration. The first launch downloads and caches the package. Alternatively, clone the repository and run `uv sync`, or build and run the provided Docker image.

It needs `INTERVALS_ICU_API_KEY` and `INTERVALS_ICU_ATHLETE_ID`. Create the API key in Intervals.icu under Settings → Developer, then copy the athlete ID from the profile URL, such as `i123456`.

Yes, intervals-icu-mcp works with Cursor through a stdio MCP configuration. Add the `uvx intervals-icu-mcp` command to `~/.cursor/mcp.json` or a project-local `.cursor/mcp.json`, provide both environment variables, and restart Cursor.

Yes, but ChatGPT requires a different setup.

Related MCP servers

All in Sports All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewIntervals Icu MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/intervals-icu-mcp?style=directory)](https://allmcps.com/mcp/intervals-icu-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/intervals-icu-mcp"><img src="https://allmcps.com/api/badge/intervals-icu-mcp?style=directory" alt="Intervals Icu MCP on AllMCPs" /></a>