Intervals.icu MCP

Name: Intervals.icu MCP
Author: hhopke

hhopke

Reads and writes Intervals.icu data so agents can review training and wellness metrics, plan sessions and generate structured workouts.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add intervals-icu --env INTERVALS_ICU_API_KEY='<INTERVALS_ICU_API_KEY>' --env INTERVALS_ICU_ATHLETE_ID='<INTERVALS_ICU_ATHLETE_ID>' -- uvx intervals-icu-mcp

~/.codex/config.toml

[mcp_servers.intervals-icu]
command = "uvx"
args = ["intervals-icu-mcp"]
env = { INTERVALS_ICU_API_KEY = "<INTERVALS_ICU_API_KEY>", INTERVALS_ICU_ATHLETE_ID = "<INTERVALS_ICU_ATHLETE_ID>" }

# codex mcp add intervals-icu --env INTERVALS_ICU_API_KEY='<INTERVALS_ICU_API_KEY>' --env INTERVALS_ICU_ATHLETE_ID='<INTERVALS_ICU_ATHLETE_ID>' -- uvx intervals-icu-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "intervals-icu": {
      "command": "uvx",
      "args": [
        "intervals-icu-mcp"
      ],
      "env": {
        "INTERVALS_ICU_API_KEY": "<INTERVALS_ICU_API_KEY>",
        "INTERVALS_ICU_ATHLETE_ID": "<INTERVALS_ICU_ATHLETE_ID>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "intervals-icu": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "intervals-icu-mcp"
      ],
      "env": {
        "INTERVALS_ICU_API_KEY": "<INTERVALS_ICU_API_KEY>",
        "INTERVALS_ICU_ATHLETE_ID": "<INTERVALS_ICU_ATHLETE_ID>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "intervals-icu": {
      "command": "uvx",
      "args": [
        "intervals-icu-mcp"
      ],
      "env": {
        "INTERVALS_ICU_API_KEY": "<INTERVALS_ICU_API_KEY>",
        "INTERVALS_ICU_ATHLETE_ID": "<INTERVALS_ICU_ATHLETE_ID>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "intervals-icu": {
      "command": "uvx",
      "args": [
        "intervals-icu-mcp"
      ],
      "env": {
        "INTERVALS_ICU_API_KEY": "<INTERVALS_ICU_API_KEY>",
        "INTERVALS_ICU_ATHLETE_ID": "<INTERVALS_ICU_ATHLETE_ID>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "intervals-icu": {
      "command": "uvx",
      "args": [
        "intervals-icu-mcp"
      ],
      "env": {
        "INTERVALS_ICU_API_KEY": "<INTERVALS_ICU_API_KEY>",
        "INTERVALS_ICU_ATHLETE_ID": "<INTERVALS_ICU_ATHLETE_ID>"
      }
    }
  }
}

Environment variables

INTERVALS_ICU_API_KEY
INTERVALS_ICU_ATHLETE_ID

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related