Skip to main content
MCP server CX Codex

Futureweb Intervals MCP — Claude Code MCP server: what it does

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

GPL-3.0 ★ 14 updated 2026-10-21

Install into Claude Code · Platform CLI All methods and platforms ↓
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
Open on GitHub

What Futureweb Intervals MCP 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+.

What it helps with

  • 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 for the agent

  • 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

How to install Futureweb Intervals MCP

Platform CLI

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>

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Futureweb Intervals MCP

How to install Futureweb Intervals MCP in Claude Code?

Run claude mcp add intervals-mcp-server -e API_KEY=<API_KEY> -e ATHLETE_ID=<ATHLETE_ID> -- uvx futureweb-intervals-mcp, substituting your API key and athlete ID from Intervals.icu.

What does Futureweb Intervals MCP do?

It reads training data from Intervals.icu and gives the agent tools to analyse activities, intervals, wellness, recovery, planned vs executed workouts, and to build load and intensity summaries.

Can this server modify data in Intervals.icu?

Read-only by default. Write and delete are enabled via the MCP_PERMISSIONS environment variable; every write operation is validated before submission and read back for confirmation.

Similar MCP servers

All MCP servers for Data and databases →

Project sponsors

Companies that keep this analytics open