Intervals.icu
The Intervals.icu MCP Server connects Claude and ChatGPT to the Intervals.icu fitness tracking API, enabling retrieval of activities, events, and wellness data through authenticated API calls. It provides tools for athletes to access their training and health information from Intervals.icu directly within AI conversations, requiring Python 3.12, an API key, and athlete ID for authentication.
- GitHub stars
- 264
- tools
- 16
- last updated
- Mar 5, 2026
Tools
16 toolsPublic tool metadata for what this MCP can expose to an agent.
get_activitiesRetrieve a list of activities
Retrieve a list of activities
No parameter schema in public metadata yet.
get_activity_detailsGet detailed information for a specific activity
Get detailed information for a specific activity
No parameter schema in public metadata yet.
get_activity_intervalsGet detailed interval data for a specific activity
Get detailed interval data for a specific activity
No parameter schema in public metadata yet.
get_activity_streamsGet raw data streams (power, heart rate, etc.) for a specific activity
Get raw data streams (power, heart rate, etc.) for a specific activity
No parameter schema in public metadata yet.
get_athlete_power_curvesGet best power output curves for selected durations and time periods
Get best power output curves for selected durations and time periods
No parameter schema in public metadata yet.
get_wellness_dataFetch wellness data
Fetch wellness data
No parameter schema in public metadata yet.
get_eventsRetrieve upcoming events (workouts, races, etc.)
Retrieve upcoming events (workouts, races, etc.)
No parameter schema in public metadata yet.
get_event_by_idGet detailed information for a specific event
Get detailed information for a specific event
No parameter schema in public metadata yet.
add_or_update_eventCreate or update an event (workout, race, note, etc.)
Create or update an event (workout, race, note, etc.)
No parameter schema in public metadata yet.
delete_eventDelete a specific event
Delete a specific event
No parameter schema in public metadata yet.
delete_events_by_date_rangeDelete events within a date range
Delete events within a date range
No parameter schema in public metadata yet.
get_custom_itemsGet custom items (charts, custom fields, zones, etc.) for an athlete
Get custom items (charts, custom fields, zones, etc.) for an athlete
No parameter schema in public metadata yet.
get_custom_item_by_idGet detailed information for a specific custom item
Get detailed information for a specific custom item
No parameter schema in public metadata yet.
create_custom_itemCreate a new custom item for an athlete
Create a new custom item for an athlete
No parameter schema in public metadata yet.
update_custom_itemUpdate an existing custom item
Update an existing custom item
No parameter schema in public metadata yet.
delete_custom_itemDelete a custom item
Delete a custom item
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
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:
where.exe uv
# Example output: C:\Users\<USERNAME>\.local\bin\uv.exe
2. Clone this repository
git clone https://github.com/mvilanova/intervals-mcp-server.git
cd intervals-mcp-server