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
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-mcpWhat 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-mcpReplace <…> 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>
Platform CLI
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-mcpReplace <…> 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>
Config file
{
"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>
Config file
{
"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>
Platform CLI
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-mcpReplace <…> 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.