Intervals.icu
Enables AI assistants to interact with Intervals.icu fitness tracking and wellness data, allowing users to fetch, filter, and group activities or health metrics. It provides structured summaries of workouts and physical well-being through natural lan
What is Intervals.icu?
Intervals.icu is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables ai assistants to interact with intervals.icu fitness tracking and wellness data, allowing users to fetch, filter, and group activities or health metrics. it provides structured summaries of wo...
Enables AI assistants to interact with Intervals.icu fitness tracking and wellness data, allowing users to fetch, filter, and group activities or health metrics. It provides structured summaries of workouts and physical well-being through natural lan
This server falls under the Analytics category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables AI assistants to interact with Intervals.icu fitness
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx intervals-icu-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Intervals.icu
The Intervals.icu MCP server enables AI assistants to fetch, filter, and analyze your fitness tracking and wellness data from Intervals.icu through natural language. It connects to the Intervals.icu REST API using your personal API key and athlete ID, exposing 13 tools covering activities, power curve analysis, wellness metrics (HRV, sleep, weight), calendar events, and custom data fields. Athletes and coaches use it to get AI-generated summaries of training blocks, compare performance trends, and manage their training calendar without leaving their AI assistant.
Prerequisites
- Python 3.12 or higher
- uv package manager for running the server
- An Intervals.icu account with an API key (from Settings > API)
- Your Intervals.icu athlete ID (the i-prefixed ID from your profile URL)
- An MCP-compatible client such as Claude Desktop
Install uv and clone the repository
Install the uv package manager and clone the intervals-mcp-server repository to your local machine.
curl -LsSf https://astral.sh/uv/install.sh | sh
git clone https://github.com/mvilanova/intervals-mcp-server.git
cd intervals-mcp-serverSet up the Python virtual environment
Create a Python 3.12 virtual environment and install all dependencies using uv sync.
uv venv --python 3.12
source .venv/bin/activate
uv syncConfigure your Intervals.icu credentials
Copy the example env file and add your API key and athlete ID. Your athlete ID is the i-prefixed value in your Intervals.icu profile URL.
cp .env.example .env
# Edit .env and set:
# API_KEY=your_api_key_here
# ATHLETE_ID=i12345
# INTERVALS_API_BASE_URL=https://intervals.icu/api/v1
# LOG_LEVEL=INFORegister the server with Claude Desktop
Use the mcp install command to register and configure the server. It reads credentials from your .env file automatically.
mcp install src/intervals_mcp_server/server.py \
--name "Intervals.icu" \
--with-editable . \
--env-file .envRestart Claude Desktop and start querying
Restart Claude Desktop after registration. The Intervals.icu server exposes 13 tools for activities, wellness data, power curves, events, and custom items — all accessible through natural language.
Intervals.icu Examples
Client configuration
Claude Desktop config for the Intervals.icu MCP server with credentials passed as environment variables.
{
"mcpServers": {
"intervals-icu": {
"command": "/full/path/to/uv",
"args": [
"run",
"--with-editable",
"/path/to/intervals-mcp-server",
"python",
"/path/to/intervals-mcp-server/src/intervals_mcp_server/server.py"
],
"env": {
"API_KEY": "your_intervals_icu_api_key",
"ATHLETE_ID": "i12345",
"INTERVALS_API_BASE_URL": "https://intervals.icu/api/v1",
"LOG_LEVEL": "INFO"
}
}
}
}Prompts to try
Natural language prompts for analyzing training and wellness data from Intervals.icu.
- "List my last 20 running activities with pace, distance, and heart rate"
- "What is my best 5-minute power output in the last 6 months?"
- "Summarize my wellness trends for this training block — HRV, sleep quality, and fatigue"
- "Compare my training load from last month vs. this month"
- "Show upcoming events on my Intervals.icu calendar for the next 4 weeks"Troubleshooting Intervals.icu
401 Unauthorized error when connecting to Intervals.icu
Verify your API_KEY is correct by testing it directly: curl -u 'API_KEY:your_key' https://intervals.icu/api/v1/athlete/i12345. Generate a new API key from Intervals.icu Settings > API if needed.
Server fails to start with Python version error
The server requires Python 3.12+. Run uv python install 3.12 to install it, then recreate the virtual environment with uv venv --python 3.12.
Claude Desktop shows the server as disconnected after restart
Use the full absolute path to the uv executable in your claude_desktop_config.json (find it with which uv). Relative paths and shell aliases are not resolved in the MCP server launch environment.
Frequently Asked Questions about Intervals.icu
What is Intervals.icu?
Intervals.icu is a Model Context Protocol (MCP) server that enables ai assistants to interact with intervals.icu fitness tracking and wellness data, allowing users to fetch, filter, and group activities or health metrics. it provides structured summaries of workouts and physical well-being through natural lan It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Intervals.icu?
Follow the installation instructions on the Intervals.icu GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Intervals.icu?
Intervals.icu works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Intervals.icu free to use?
Yes, Intervals.icu is open source and available under the GPL 3.0 license. You can use it freely in both personal and commercial projects.
Intervals.icu Alternatives — Similar Analytics Servers
Looking for alternatives to Intervals.icu? 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 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?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.