Happy slice of mcp pizzaMCP.pizza

intervals-mcp-server

MCP.Pizza Chef: mvilanova

Cyclists and runners who log sessions in Intervals.icu can ask Claude or ChatGPT about them in ordinary language: how last week went, whether sleep and resting heart rate are trending the right way, what is scheduled next. You will need a free personal access key from your Intervals.icu settings page along with your athlete number. Getting it running means downloading the code and installing a couple of Python tools, so set aside half an hour. Actively updated as of August 2026.

Data
Other

Use This MCP server To

Ask how my training load changed over the past month Summarize last week's rides in a few lines Check whether my sleep and resting heart rate are trending well Look up which workout is planned for tomorrow Compare this season's power curve against last season's

README

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

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

3. Create and activate a virtual environment

intervals-mcp-server FAQ

Is this still maintained?
Yes. Changes were still landing in August 2026 and the author responds to reports.
Do I need a key?
Yes. Generate a free personal access key under Settings in your Intervals.icu account, and note your athlete number from the web address.
Which apps does it work with?
Claude Desktop is the main route, and the instructions also cover connecting it to ChatGPT.
Can I use this to review my training week without opening the website?
Yes — ask for a summary of recent sessions and how your load is trending, and it reads them for you.
Can it change my training plan?
It is built around reading your data — activities, planned events, and wellness entries — rather than rewriting your plan.
Is Intervals.icu itself free?
The service has a free tier, and this connector adds no cost of its own.
How hard is setup?
Developer-level. You download the code, install Python 3.12 and the uv tool, then edit your assistant's settings file by hand.