Intervals.icu MCP Server

An MCP (Model Context Protocol) server that integrates Intervals.icu with AI assistants like Claude or ChatGPT. It exposes your training data, wellness records, planned workouts, and calendar events through a set of tools that Claude can call directly.

Features

• Athlete profile & settings — retrieve profile info and sport-specific settings (FTP, LTHR, HR zones, pace zones)

• Activities — list, search, and get detailed metrics for completed workouts

• Wellness — read daily wellness records (weight, resting HR, HRV, sleep, soreness, fatigue, stress, mood)

• Training calendar — list, create, and update planned events (workouts, races, notes, and more)

• Routes — browse saved routes with optional GPS path data

• Summary stats — aggregate training load, distance, and time over a date range

Related MCP server: intervals.icu-mcp

Available Tools

Prerequisites

• Node.js 18+

• An Intervals.icu account

• An Intervals.icu API key (found in Settings → API)

Setup

1. Clone and install dependencies

git clone <repo-url>
cd IntervalsMCP
npm install

2. Configure environment variables

cp .env.example .env

Edit .env:

INTERVALS_API_KEY=your_api_key_from_intervals_icu_settings
INTERVALS_ATHLETE_ID=i0

INTERVALS_ATHLETE_ID defaults to i0 which resolves to your own athlete ID.

3. Build

npm run build

Connecting to Claude

Add this server to your Claude Desktop (or any MCP-compatible client) configuration:

{
  "mcpServers": {
    "intervals-icu": {
      "command": "node",
      "args": ["/absolute/path/to/IntervalsMCP/dist/index.js"]
    }
  }
}

Claude Desktop config is typically located at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Development

# Watch mode — recompiles on file changes
npm run dev

# Run the compiled server directly
npm start

Project Structure

src/
  index.ts            # MCP server entry point
  intervals-client.ts # Intervals.icu API HTTP client
  tools.ts            # MCP tool definitions