# Futureweb Intervals MCP

Futureweb Intervals MCP — an MCP server for Intervals.icu training analytics: activities, custom fields, heart rate, power, recovery insights, planned vs executed workouts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 14 repo stars
- Author: futureweb
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/futureweb/intervals-mcp-server
- Updated: 2026-10-21
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/futureweb-intervals-mcp

## What it does

The server reads data from Intervals.icu and gives the agent tools to analyse training: activities with all custom fields and streams (power, heart rate, cadence, altitude), intervals, wellness metrics against personal baselines, thresholds and zones, comparison of planned and executed workouts, climbs, best efforts, power-to-heart-rate efficiency, fatigue resistance, nutrition and weight, weekly and monthly summaries.

Streams are returned at full resolution as CSV or JSON, sliced by index or time, with per-interval statistics. Ready-made prompts for coaching analysis are included, output is compact or detailed by choice (`detail_level`). Works with Garmin data via the companion Garmin Intervals Bridge project, but functional without it. Read-only by default; write, delete and admin operations are enabled via `MCP_PERMISSIONS` and `MCP_TOOLSET` environment variables.

Runs locally or remotely with a built-in OAuth 2.1 server and per-connection consent page. Requires API_KEY and ATHLETE_ID from Intervals.icu, Python 3.12+.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `API_KEY`, `ATHLETE_ID`, `MCP_PERMISSIONS`, `MCP_TOOLSET`, `ATHLETE_TIMEZONE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env API_KEY=<API_KEY> --env ATHLETE_ID=<ATHLETE_ID> --env MCP_PERMISSIONS=<MCP_PERMISSIONS> --env MCP_TOOLSET=<MCP_TOOLSET> --env ATHLETE_TIMEZONE=<ATHLETE_TIMEZONE> --transport stdio futureweb-intervals-mcp -- uvx futureweb-intervals-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from futureweb-intervals-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add futureweb-intervals-mcp --env API_KEY=<API_KEY> --env ATHLETE_ID=<ATHLETE_ID> --env MCP_PERMISSIONS=<MCP_PERMISSIONS> --env MCP_TOOLSET=<MCP_TOOLSET> --env ATHLETE_TIMEZONE=<ATHLETE_TIMEZONE> -- uvx futureweb-intervals-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from futureweb-intervals-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "futureweb-intervals-mcp": {
            "command": "uvx",
            "args": [
                "futureweb-intervals-mcp"
            ],
            "env": {
                "API_KEY": "<API_KEY>",
                "ATHLETE_ID": "<ATHLETE_ID>",
                "MCP_PERMISSIONS": "<MCP_PERMISSIONS>",
                "MCP_TOOLSET": "<MCP_TOOLSET>",
                "ATHLETE_TIMEZONE": "<ATHLETE_TIMEZONE>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from futureweb-intervals-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "futureweb-intervals-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "futureweb-intervals-mcp"
            ],
            "env": {
                "API_KEY": "<API_KEY>",
                "ATHLETE_ID": "<ATHLETE_ID>",
                "MCP_PERMISSIONS": "<MCP_PERMISSIONS>",
                "MCP_TOOLSET": "<MCP_TOOLSET>",
                "ATHLETE_TIMEZONE": "<ATHLETE_TIMEZONE>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from futureweb-intervals-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e API_KEY=<API_KEY> -e ATHLETE_ID=<ATHLETE_ID> -e MCP_PERMISSIONS=<MCP_PERMISSIONS> -e MCP_TOOLSET=<MCP_TOOLSET> -e ATHLETE_TIMEZONE=<ATHLETE_TIMEZONE> futureweb-intervals-mcp uvx futureweb-intervals-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from futureweb-intervals-mcp <command>

## When to use it
- analyse a completed workout and compare it to the plan
- track wellness and recovery metrics over 42 days
- find similar intervals and trace progress in repeated workouts
- check power-to-heart-rate efficiency and fatigue resistance
- get a weekly or monthly training load and intensity summary

## Example prompts
- Analyse my last workout and show how closely it matched the plan
- Show resting heart rate and HRV trends over the past six weeks
- Find all intervals above 300 W and compare their duration

## Similar
- [Fitness AI Connector](https://affpapa.org/en/nevibecode/mcp/fitness-ai-connector.md) — MCP server · ★ 9 repo stars
- [Long Run Hybrid Coach](https://affpapa.org/en/nevibecode/mcp/long-run-hybrid-coach.md) — MCP server · ★ 7 repo stars
- [intervals-icu-mcp](https://affpapa.org/en/nevibecode/mcp/intervals-icu-mcp.md) — MCP server · ★ 127 repo stars
- [Garmin Connect](https://affpapa.org/en/nevibecode/mcp/garmin-connect.md) — MCP server · ★ 76 repo stars
- [Run Coach](https://affpapa.org/en/nevibecode/mcp/run-coach.md) — MCP server · ★ 17 repo stars
- [kaiord](https://affpapa.org/en/nevibecode/mcp/kaiord.md) — MCP server · ★ 12 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
