Skip to content
MCP server

Futureweb Intervals MCP

Self-hosted Intervals.icu MCP server for training, Garmin and recovery analysis

Runs locallyStatus and history
Pricing
Open source
Platforms
self-hosted, CLI, Linux
Runs
Locally
Version
1.0.0b2
Listing updated
1 day ago

About Futureweb Intervals MCP

Futureweb Intervals MCP is an open-source MCP server for health and science. It runs locally on your machine and is started by your AI client.

Built as a community-maintained continuation of mvilanova/intervals-mcp-server, this server reads your Intervals.icu training data the way a coach would. It resolves your own custom activity, interval, stream and wellness fields dynamically, keeps null, NaN and zero distinct, and returns streams at full resolution as summary, CSV or JSON. It is not affiliated with Intervals.icu or Garmin.

Analysis tools go beyond raw dumps: an activity report, planned versus executed per step, climbs, second power meter checks, best efforts, power-to-heart-rate efficiency, fatigue resistance, training load with acute:chronic ratio, polarization index, recovery snapshots against 42-day baselines, nutrition and weight trends and weekly summaries. It works with the companion Garmin Intervals Bridge, which restores metrics Garmin strips from synced files, and with intervals-summits for mountain tours.

It is read-only by default. Permission classes (read, write, destructive, admin) are enforced on the server, and writes validate workouts, support dry_run and refuse an identical event on the same day. Remote access uses a built-in OAuth 2.1 server with Streamable HTTP and SSE. A full tool catalogue costs about 23k tokens, with a core set of about 10k.

Install

Run in a terminal

claude mcp add intervals-mcp-server --env API_KEY='<API_KEY>' --env ATHLETE_ID='<ATHLETE_ID>' -- uvx futureweb-intervals-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "intervals-mcp-server": {
      "command": "uvx",
      "args": [
        "futureweb-intervals-mcp"
      ],
      "env": {
        "API_KEY": "<API_KEY>",
        "ATHLETE_ID": "<ATHLETE_ID>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "intervals-mcp-server": {
      "command": "uvx",
      "args": [
        "futureweb-intervals-mcp"
      ],
      "env": {
        "API_KEY": "<API_KEY>",
        "ATHLETE_ID": "<ATHLETE_ID>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "intervals-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "futureweb-intervals-mcp"
      ],
      "env": {
        "API_KEY": "<API_KEY>",
        "ATHLETE_ID": "<ATHLETE_ID>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "intervals-mcp-server": {
      "command": "uvx",
      "args": [
        "futureweb-intervals-mcp"
      ],
      "env": {
        "API_KEY": "<API_KEY>",
        "ATHLETE_ID": "<ATHLETE_ID>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "intervals-mcp-server": {
      "command": "uvx",
      "args": [
        "futureweb-intervals-mcp"
      ],
      "env": {
        "API_KEY": "<API_KEY>",
        "ATHLETE_ID": "<ATHLETE_ID>"
      }
    }
  }
}

Configuration

  • API_KEYIntervals.icu API key (Settings > Developer Settings)Required
  • ATHLETE_IDIntervals.icu athlete IDRequired
  • MCP_PERMISSIONSEnabled tool classes: read (default, read-only), read,write, or all (adds destructive and admin tools)
  • MCP_TOOLSETfull (every tool of the enabled classes) or core (curated coaching set)
  • ATHLETE_TIMEZONETime zone for 'today' and default date ranges, e.g. Europe/Vienna; default: the Intervals.icu athlete profile
  • API_KEYIntervals.icu API key (Settings > Developer Settings)Required
  • ATHLETE_IDIntervals.icu athlete IDRequired
  • MCP_PERMISSIONSEnabled tool classes: read (default, read-only), read,write, or all (adds destructive and admin tools)
  • MCP_TOOLSETfull (every tool of the enabled classes) or core (curated coaching set)
  • ATHLETE_TIMEZONETime zone for 'today' and default date ranges, e.g. Europe/Vienna; default: the Intervals.icu athlete profile

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

get_activity_details
Details of one activity including custom fields
get_activity_report
One-call activity report
get_training_summary
Weekly or monthly training summary
get_training_load
Training load including device loads kept apart
get_fueling_analysis
Fueling analysis such as sweat loss per hour
get_activity_data_audit
Shows which fields hold a zero placeholder or no value
get_guide
Returns method guides

What it does

Dynamic custom fields
Reads your own field and stream definitions rather than hard-coded ones.
Coaching analyses
Efficiency, fatigue resistance, load ratios and polarization over time.
Garmin-enriched data
Reads metrics restored by the Garmin Intervals Bridge.
Permission classes
Only read is active unless write, destructive or admin are enabled.
Safe writes
Validation, dry_run and read-back confirm each stored workout.
OAuth 2.1 remote access
Continue with Intervals.icu sign-in and per-connection permissions.

Good for

  • Review planned versus executed steps of a ride
  • Check recovery against personal baselines
  • Ask which summits you climbed this year
  • Plan a workout whose intervals start at the foot of a climb
  • Track nutrition and weight trends

Pricing

Open source

Free to self-host; requires an Intervals.icu account

Futureweb Intervals MCP FAQ

Does it change my data by default?

No. Only read tools are active unless you set MCP_PERMISSIONS to include write or all.

What do I need to connect?

An Intervals.icu API key and athlete ID.

Is it official?

No. It is a community fork, not affiliated with Intervals.icu or Garmin.

How big is the tool catalogue?

About 23k tokens for read and write, or about 10k with the core set.

Is Futureweb Intervals MCP free?

Yes. Futureweb Intervals MCP is open source, so you can use and self-host it for free.

How do I add Futureweb Intervals MCP to Claude Code?

Run this command in your terminal: claude mcp add intervals-mcp-server --env API_KEY='<API_KEY>' --env ATHLETE_ID='<ATHLETE_ID>' -- uvx futureweb-intervals-mcp

What are the best alternatives to Futureweb Intervals MCP?

The closest alternatives to Futureweb Intervals MCP are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

Alternatives to Futureweb Intervals MCP

  1. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  2. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  3. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  4. Read-only local index of medical-device standards with official links, no standard text

    Runs locally
    • 4 tools
    • Free
    • Legal and government
  5. Splyt

    MCP server

    Let Claude or ChatGPT read your Splyt workouts, records, plan, habits and sleep

    • Remote
    • Free
    • Health and science