Intervals.icu MCP Server
Model Context Protocol (MCP) server for connecting Claude with the Intervals.icu API. It provides tools for authentication and data retrieval for activities, events, and wellness data.
Requirements
- Python 3.10 or higher
- Model Context Protocol (MCP) Python SDK
- httpx
- python-dotenv
Setup
1. Install uv (recommended)
2. Clone this repository
3. Create and activate a virtual environment
4. Install dependencies
5. Set up environment variables
Make a copy of .env.example
and name it .env
by running the following command:
Then edit the .env
file and set your Intervals.icu athlete id and API key:
Getting your Intervals.icu API Key
- Log in to your Intervals.icu account
- Go to Settings > API
- Generate a new API key
Finding your Athlete ID
Your athlete ID is typically visible in the URL when you're logged into Intervals.icu. It looks like:
https://intervals.icu/athlete/i12345/...
wherei12345
is your athlete ID
Usage
1. Configure Claude Desktop
To use this server with Claude Desktop, you need to add it to your Claude Desktop configuration.
- Run the following from the
intervals_mcp_server
directory to configure Claude Desktop:
- If you open your Claude Desktop App configuration file
claude_desktop_config.json
, it should look like this:
Where /path/to/
is the path to the intervals-mcp-server
code folder in your system.
If you observe the following error messages when you open Claude Desktop, include the full path to uv
in the command key in the claude_desktop_config.json
configuration file. You can get the full path by running which uv
in the terminal.
- Restart Claude Desktop.
2. Use the MCP server with Claude
Once the server is running and Claude Desktop is configured, you can use the following tools to ask questions about your past and future activities, events, and wellness data.
get_activities
: Retrieve a list of activitiesget_activity_details
: Get detailed information for a specific activityget_activity_intervals
: Get detailed interval data for a specific activityget_wellness_data
: Fetch wellness dataget_events
: Retrieve upcoming events (workouts, races, etc.)get_event_by_id
: Get detailed information for a specific event
License
The GNU General Public License v3.0
Featured
Glama.ai
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Connects Claude with the Intervals.icu API to retrieve fitness data including activities, workouts, wellness metrics, and training events.
Related MCP Servers
- AsecurityAlicenseAqualityProvides comprehensive access to Roam Research's API functionality. This server enables AI assistants like Claude to interact with your Roam Research graph through a standardized interface.Last updated -182538TypeScriptMIT License
Iaptic MCP Serverofficial
AsecurityAlicenseAqualityA server for interacting with the Iaptic API, allowing AI models like Claude to query customer, purchase, and transaction data, as well as retrieve statistical insights.Last updated -164TypeScriptMIT License- AsecurityFlicenseAqualityA server that enables Claude Desktop users to access the Claude API directly, allowing them to bypass Professional Plan limitations and use advanced features like custom system prompts and conversation management.Last updated -15Python
- -securityAlicense-qualityConnects to Garmin Connect and exposes your fitness and health data (activities, sleep, heart rate, steps, body composition) to Claude and other MCP-compatible clients.Last updated -1PythonMIT License