io.github.ljcl/intervals-mcp MCP Server

io.github.ljcl/intervals-mcp

Repository Registry

What is the io.github.ljcl/intervals-mcp MCP server?

Remote MCP server for intervals.icu run data and analysis

How to install io.github.ljcl/intervals-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

INTERVALS_API_KEY
required
secret
intervals.icu personal API key (Settings, Developer Settings)
INTERVALS_ATHLETE_ID
Athlete id; default 0 means the API key's own athlete
TZ
IANA time zone for local dates, e.g. Australia/Sydney
MCP_AUTH_TOKEN
secret
Shared secret gating /mcp and detailed /health (recommended when internet-facing)
PORT
Server port (default 3000)
PUBLIC_URL
Public URL, used only to warn when /mcp is exposed without MCP_AUTH_TOKEN

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "intervals-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ljcl/intervals-mcp:2.1.1"
      ],
      "env": {
        "INTERVALS_API_KEY": "<YOUR_INTERVALS_API_KEY>",
        "INTERVALS_ATHLETE_ID": "<YOUR_INTERVALS_ATHLETE_ID>",
        "TZ": "<YOUR_TZ>",
        "MCP_AUTH_TOKEN": "<YOUR_MCP_AUTH_TOKEN>",
        "PORT": "<YOUR_PORT>",
        "PUBLIC_URL": "<YOUR_PUBLIC_URL>"
      }
    }
  }
}