intervals-icu-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
intervals-icu-mcp
An MCP (Model Context Protocol) server for Intervals.icu, read-only by default.
Gives any MCP-compatible AI assistant access to your activities, wellness data, fitness curves, training zones, and calendar.
Optionally, it can also create planned workouts on your calendar (see Write tools).
Compatible with any client that supports the MCP protocol, including Claude (Desktop, Code, and Web), Cursor, Windsurf, and others.
Available Tools
Tool | Description |
| Profile, FTP, weight, VO2max, thresholds |
| Power, HR and pace training zones |
| Bikes, shoes and usage stats |
| Currently assigned training plan |
| Activities list with date range and sport type filters |
| Full activity detail + detected intervals |
| Raw second-by-second data (power, HR, cadence, altitude…) |
| Mean maximal power (MMP) curve |
| CTL/ATL/TSB fitness curve over a date range |
| Daily wellness entries over a date range (HRV, sleep, weight, mood…) |
| Single-day wellness entry |
| All calendars configured for the athlete |
| Calendar events with date range and category filter |
| Single calendar event by ID |
These are the only tools registered unless you opt in to writes.
Write tools (opt-in)
Set INTERVALS_ALLOW_WRITES=true to also register these tools. Without it the server cannot change anything in your account.
Tool | Description |
| Create a calendar event, typically a planned workout written in Intervals.icu workout text |
| Change the date, name, workout text, sport type or indoor flag of an event |
| Delete a single event (only that one) |
| Export a planned workout as fit/zwo/mrc/erg, to check it converted to real steps |
Workouts use the same text format as the Intervals.icu workout builder, for example:
Warmup
- 10m 55%
Main set 3x
- 2km 90%
- 500mtr 55%
Cooldown
- 10m 50%Each step is a line starting with - . 10m means 10 minutes; distances are written 2km or 500mtr (metres). Targets can be % of FTP, watts (200w) or zones (Z2). A line ending in 3x starts a repeat block that runs until the next blank line.
Planned workouts reach a Garmin device through Garmin Connect only if Upload planned workouts is switched on in the Garmin section of Intervals.icu settings.
Related MCP server: Intervals.icu MCP Server
Prerequisites
Node.js v18 or later
An Intervals.icu account with an API key
Get your API key:
Log in to intervals.icu
Go to Settings → scroll down to Developer Settings
Generate (or copy) your API Key
Installation
No installation needed — npx downloads and runs the package automatically.
Add the following to your MCP client config, replacing your_api_key_here with your key:
{
"mcpServers": {
"intervals-icu": {
"command": "npx",
"args": ["-y", "intervals-icu-mcp"],
"env": {
"INTERVALS_API_KEY": "your_api_key_here",
"INTERVALS_ATHLETE_ID": "0",
"TRANSPORT": "stdio"
}
}
}
}INTERVALS_ATHLETE_ID can be left as 0 — the API resolves it automatically from your key.
To enable the write tools, add "INTERVALS_ALLOW_WRITES": "true" to env.
Config file locations:
Client | Config file |
Claude Desktop (macOS) |
|
Claude Desktop (Windows) |
|
Cursor |
|
Windsurf |
|
After editing the config, fully restart your client. If an older version keeps loading, use "intervals-icu-mcp@latest" in args so npx doesn't reuse its cached copy.
Claude Code (CLI)
claude mcp add intervals-icu \
-e INTERVALS_API_KEY=your_api_key_here \
-e INTERVALS_ATHLETE_ID=0 \
-e TRANSPORT=stdio \
-- npx -y intervals-icu-mcpAdd -e INTERVALS_ALLOW_WRITES=true to enable the write tools.
Environment variables
Variable | Required | Default | Description |
| ✅ | — | Your Intervals.icu API key |
| — |
| Your athlete ID ( |
| — |
|
|
| — |
| HTTP port (Docker/remote mode only) |
| — | off |
|
Example prompts
"Show me my last 10 cycling activities"
"What was my CTL/ATL trend over the past 3 months?"
"Get the power curve for activity i12345678"
"How did my HRV look last week?"
"What are my current power training zones?"
"List my planned workouts for the next 2 weeks"
"What bikes do I have configured?"
"Show me today's wellness entry"
"Put a 3x2km sweet-spot workout on my calendar for Saturday" (needs INTERVALS_ALLOW_WRITES=true)Development
See DEVELOPMENT.md for instructions on running locally, using Docker, and contributing.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect Intervals.icu to Claude and ChatGPT: read training, plan workouts. Training never stored.
Connect Claude to your Intervals.icu watch data for fitness, workout review, and plan writing.
Your endurance training data in your AI assistant: activities, recovery, plan, workout edits.
tri-train is a training platform for triathletes that syncs activities from Strava and Garmin and exposes them to Claude through a remote MCP server. Ask Claude how your last block went, why your run pace dropped, or whether you are fresh enough for Sunday's race, and it answers from your real data: activities with laps and grade-adjusted pace, weekly load and the performance management chart (CTL/ATL/TSB), sleep, HRV and resting heart rate, and your race calendar with predictions. Claude can also act: create and adjust planned workouts with structured intervals, push them to your Garmin watch, add races and write notes. Every change is journaled and can be undone. Read and write access are separate OAuth scopes, and the server enforces them on every call. Built and hosted in Switzerland by a triathlete; data stays on our own servers (Swiss revDSG / GDPR).
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables AI assistants to access and analyze intervals.icu training data including activities, fitness metrics (CTL/ATL/TSB), wellness stats, and calendar events. Supports natural language querying of athletic performance for training insights and workout planning.6-
- AlicenseNot gradedqualityFmaintenanceIntegrates Intervals.icu training data, wellness records, workouts, and calendar events with AI assistants through MCP tools.133 npm1MIT
- AlicenseAqualityDmaintenanceProvides AI assistants with read-only access to an athlete's Intervals.icu training data, including activities, wellness metrics, zones, and planned events, for use with MCP clients like ChatGPT and Claude.15MIT
- AlicenseAqualityBmaintenanceEnables Claude and ChatGPT to access and manage Intervals.icu data, including activities, events, wellness metrics, power curves, and custom items through natural language.26GPL 3.0