Intervals.icu API MCP Server

An MCP (Model Context Protocol) server that wraps the Intervals.icu API, giving AI assistants like Claude and GitHub Copilot direct access to your training data, activities, wellness records, workouts, and more.

Getting Your API Key

1. Go to https://intervals.icu/settings
2. Scroll to Developer Settings
3. Copy your API Key
4. Note your Athlete ID (shown on the same page, e.g. i12345) when asking questions you should at first include your athlete ID

Configuration

VS Code (GitHub Copilot)

Add the following to your VS Code settings (.vscode/mcp.json in your workspace or user settings):

{
  "servers": {
    "intervals-icu": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "intervals-icu-api-mcp-server"],
      "env": {
        "API_USERNAME": "API_KEY",
        "API_PASSWORD": "your-api-key-here"
      }
    }
  }
}

Claude Desktop

Add the following to your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "intervals-icu": {
      "command": "npx",
      "args": ["-y", "intervals-icu-api-mcp-server"],
      "env": {
        "API_USERNAME": "API_KEY",
        "API_PASSWORD": "your-api-key-here"
      }
    }
  }
}

Replace your-api-key-here with the API key from your Intervals.icu settings.

Note: The API_USERNAME value is literally API_KEY — it is not a placeholder. Leave it as-is. Only replace the API_PASSWORD value with your actual API key.

Environment Variables

| Variable | Description | |---|---| | API_USERNAME | Set to API_KEY | | API_PASSWORD | Your Intervals.icu API key |