Intervals.icu Fitness
Read/write MCP server for Intervals.icu — 51 tools spanning activities, streams, wellness, calendar, gear, and sport zones, plus structured workout generation with a built-in syntax reference for cycling, running, and swimming.
What is Intervals.icu Fitness?
Intervals.icu Fitness is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to read/write mcp server for intervals.icu — 51 tools spanning activities, streams, wellness, calendar, gear, and sport zones, plus structured workout generation with a built-in syntax reference for cycl...
Read/write MCP server for Intervals.icu — 51 tools spanning activities, streams, wellness, calendar, gear, and sport zones, plus structured workout generation with a built-in syntax reference for cycling, running, and swimming.
This server falls under the Analytics category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Read/write MCP server for Intervals.icu — 51 tools spanning
Use Cases
Maintainer
Works with
Installation
PIP
pip install intervals-icu-mcpManual Installation
pip install intervals-icu-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Intervals.icu Fitness
intervals-icu-mcp is a read/write MCP server for the Intervals.icu training platform that exposes 58 tools across 11 categories — covering activities, streams, wellness metrics, calendar events, gear management, sport zones, performance curves, and workout library access. It also provides 4 MCP resources and 7 prompt templates, plus a built-in structured workout syntax reference for generating cycling, running, and swimming sessions. Athletes and coaches use it to ask natural-language questions about training data, plan future workouts, and automate calendar management directly from an AI assistant.
Prerequisites
- Python 3.10 or later and uv package manager installed
- An Intervals.icu account (free or paid)
- An Intervals.icu API key from Settings > Developer > Create API Key
- Your Intervals.icu athlete ID (the i123456 code visible in your profile URL)
- An MCP-compatible client such as Claude Desktop or Claude Code
Install the package
Install intervals-icu-mcp from PyPI using pip or uv.
pip install intervals-icu-mcp
# or with uv
uv pip install intervals-icu-mcpGet your Intervals.icu credentials
Log in to Intervals.icu, go to Settings > Developer, and click 'Create API Key'. Also copy your athlete ID from your profile URL — it looks like i123456.
Register the server with Claude Code
Add the server as a user-scoped MCP server in Claude Code, passing your API key and athlete ID as environment variables.
claude mcp add intervals-icu --scope user \
--env INTERVALS_ICU_API_KEY=your-api-key \
--env INTERVALS_ICU_ATHLETE_ID=i123456 \
-- uvx intervals-icu-mcpConfigure Claude Desktop (alternative)
For Claude Desktop, add the server configuration manually to claude_desktop_config.json.
{
"mcpServers": {
"intervals-icu": {
"command": "uvx",
"args": ["intervals-icu-mcp"],
"env": {
"INTERVALS_ICU_API_KEY": "your-api-key",
"INTERVALS_ICU_ATHLETE_ID": "i123456"
}
}
}
}Configure delete mode (optional)
By default, the server uses 'safe' delete mode which restricts destructive operations. Set INTERVALS_ICU_DELETE_MODE to 'full' to allow all deletes, or 'none' to disable them entirely.
# In your MCP env config:
INTERVALS_ICU_DELETE_MODE=safe # Options: safe | full | noneIntervals.icu Fitness Examples
Client configuration
Claude Desktop configuration with required environment variables for Intervals.icu.
{
"mcpServers": {
"intervals-icu": {
"command": "uvx",
"args": ["intervals-icu-mcp"],
"env": {
"INTERVALS_ICU_API_KEY": "your-api-key",
"INTERVALS_ICU_ATHLETE_ID": "i123456",
"INTERVALS_ICU_DELETE_MODE": "safe"
}
}
}
}Prompts to try
Example prompts for training analysis and workout planning.
- "Show me my activities from the last 30 days and highlight the longest ones"
- "Am I overtraining? Check my current CTL, ATL, and TSB fitness metrics"
- "Create a sweet spot cycling workout for tomorrow: 60 minutes with 2x20 min at 88-93% FTP"
- "What was my peak 20-minute power in the last 90 days?"
- "List my gear and flag anything that has exceeded 10,000 km"Troubleshooting Intervals.icu Fitness
Authentication errors — 'Invalid API key' or 401 responses
Verify INTERVALS_ICU_API_KEY is set correctly and was copied in full from Settings > Developer. API keys are long strings — truncation is a common cause. Also check that INTERVALS_ICU_ATHLETE_ID uses the format i123456 with the leading 'i'.
Delete operations are refused even with correct credentials
The default delete mode is 'safe', which gates destructive operations. Set INTERVALS_ICU_DELETE_MODE=full in your environment to enable full delete capability.
uvx command not found when using Claude Code
Install uv first: 'curl -LsSf https://astral.sh/uv/install.sh | sh'. Then verify 'uvx --version' works in your terminal before re-adding the MCP server.
Frequently Asked Questions about Intervals.icu Fitness
What is Intervals.icu Fitness?
Intervals.icu Fitness is a Model Context Protocol (MCP) server that read/write mcp server for intervals.icu — 51 tools spanning activities, streams, wellness, calendar, gear, and sport zones, plus structured workout generation with a built-in syntax reference for cycling, running, and swimming. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Intervals.icu Fitness?
Install via pip with: pip install intervals-icu-mcp. Then configure your AI client to connect to this MCP server.
Which AI clients work with Intervals.icu Fitness?
Intervals.icu Fitness works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Intervals.icu Fitness free to use?
Yes, Intervals.icu Fitness is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Intervals.icu Fitness Alternatives — Similar Analytics Servers
Looking for alternatives to Intervals.icu Fitness? Here are other popular analytics servers you can use with Claude, Cursor, and VS Code.
OpenMetadata
★ 14.0kOpenMetadata is a unified metadata platform for data discovery, data observability, and data governance powered by a central metadata repository, in-depth column level lineage, and seamless team collaboration.
Superset
★ 10.9kAn MCP server that provides AI assistants with full access to Apache Superset instances, enabling interaction with dashboards, charts, datasets, databases, and SQL execution capabilities.
Horizon
★ 4.4k📡 Your own AI-powered news radar. Generates daily briefings in English & Chinese. | 用 AI 构建你专属的新闻雷达
MCP Server Chart
★ 4.1kEnables generation of 25+ types of charts and data visualizations using AntV, including bar charts, line charts, maps, mind maps, and specialized diagrams like fishbone and sankey charts. Supports both statistical charts and geographic visualizations
Muapi CLI
★ 997Official CLI for muapi.ai — generate images, videos & audio from the terminal. MCP server, 14 AI models, npm + pip installable.
Weather MCP Server
★ 907Weather Data Fetcher MCP server built with Node.js, MCP SDK, and Zod. Provides weather details like temperature and forecast for cities such as Noida and Delhi via a registered tool. Simplifies API integration, enabling structured responses for clien
Browse More Analytics MCP Servers
Explore all analytics servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Intervals.icu Fitness in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Intervals.icu Fitness?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.