Intervals.icu MCP Server
About
Model Context Protocol (MCP) server for connecting Claude and ChatGPT with the Intervals.icu API.
Details
- Author
- mvilanova
- GitHub stars
- 311
- Downloads
- 1,043
- Categories
- Developer Tools, AI
Jump to
- Retrieve and manage activities, events, and wellness data
- Access interval details, streams, and power curves
- Create, update, delete custom items (charts, fields, zones)
- Supports both stdio (Claude) and SSE (ChatGPT) transports
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Intervals.icu MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install Python 3.12+, clone the repository, create a virtual environment with uv venv --python 3.12, sync dependencies with uv sync, then set API_KEY and ATHLETE_ID in a .env file. Configure Claude Desktop by adding the server to claude_desktop_config.json using the uv command, or start the server in SSE mode for ChatGPT using environment variables MCP_TRANSPORT=sse and FASTMCP_HOST/FASTMCP_PORT.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"intervals.icu mcp server": {
"intervals-mcp-server": {
"command": "uv",
"args": [
"venv",
"--python",
"3.12"
]
}
}
}
}McpServers
{
"intervals-mcp-server": {
"command": "uv",
"args": [
"venv",
"--python",
"3.12"
]
}
}Intervals.icu MCP Server
Model Context Protocol (MCP) server for connecting Claude and ChatGPT with the Intervals.icu API. It provides tools for authentication and data retrieval for activities, events, wellness data, power curves, and custom items.
If you find the Model Context Protocol (MCP) server useful, please consider supporting its continued development with a donation.
Requirements
- Python 3.12 or higher
- Model Context Protocol (MCP) Python SDK
- httpx
- python-dotenv
Setup
1. Install uv (recommended)
macOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows (PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
After installation, find the full path to uv — you'll need it later when configuring Claude Desktop:
```powershell
where.exe uv
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
