intervals-icu-mcp

Overview

This MCP server provides extensive integration with Intervals.icu, a cycling and running training platform. It offers comprehensive access to user data through 48 tools organized into 9 categories including activities, performance analysis, wellness tracking, calendar management, and gear management. The server includes not only tools for data manipulation but also a persistent athlete profile resource and 6 pre-built prompt templates for common training scenarios.

Try asking AI

After installing, here are 7 things you can ask your AI assistant:

• get-activity-details

  Get comprehensive details for a specific activity

  Try:Get details for my last long runTry:Show me the full information for my race last weekend
• get-activity-streams

  Get time-series data (power, HR, cadence, altitude, GPS)

  Try:Show me the power data from yesterday's rideTry:Get the heart rate stream from my workout on Tuesday
• get-best-efforts

  Find peak performances across all durations in an activity

  Try:What were my best efforts in my last race?Try:Show me my best 1-hour power from this week
• get-athlete-profile

  Get athlete profile with fitness metrics and sport settings

  Try:Show my current fitness metrics and training loadTry:What's my current FTP and heart rate zones
• get-wellness-data

  Get recent wellness metrics with trends (HRV, sleep, mood, fatigue)

  Try:How's my recovery this week? Show HRV and sleep trendsTry:What was my wellness data for yesterday?
• get-calendar-events

  Get planned events and workouts from calendar

  Try:What workouts do I have planned this week?Try:Show me all my upcoming races
• create-event

  Create new calendar events (workouts, races, notes, goals)

  Try:Create a threshold workout for tomorrowTry:Add a half marathon to my calendar for November
• get-power-curves

  Analyze power curves with FTP estimation and power zones

  Try:What's my 20-minute power and FTP?Try:Show me my current power zones
• get-workout-library

  Browse workout folders and training plans

  Try:Show me my workout libraryTry:What workouts are in my threshold folder?
• get-gear-list

  Get all gear items with usage and status

  Try:Show me my gear listTry:What's the mileage on my road bike?
• update-sport-settings

  Update FTP, FTHR, pace threshold, or zone configuration

  Try:Update my FTP to 275 wattsTry:Set my running threshold pace to 4:30 per kilometer
• download-activity-file

  Download original activity file

  Try:Download the FIT file for my raceTry:Get the original file from my interval workout

Comparable tools

Installation

cd intervals-icu-mcp
uv sync

# Configure credentials
uv run intervals-icu-mcp-auth

docker build -t intervals-icu-mcp .

# Create and configure env file
touch intervals-icu-mcp.env
docker run -it --rm -v "$(pwd)/intervals-icu-mcp.env:/app/.env" intervals-icu-mcp:latest python -m intervals_icu_mcp.scripts.setup_auth

{
  "mcpServers": {
    "intervals-icu": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/ABSOLUTE/PATH/TO/intervals-icu-mcp",
        "intervals-icu-mcp"
      ]
    }
  }
}

FAQ

What authentication method does this MCP server use?

The server uses API key authentication with HTTP Basic Auth (username 'API_KEY' with your key as password). No OAuth required.

Can I use this server with other LLM clients besides Claude?

Yes, as long as the client supports the Model Context Protocol (MCP), you can use this server with any compatible LLM client.

Compare intervals-icu-mcp with