intervals.mcp

An MCP server for intervals.icu, exposing your training data to Claude and other MCP clients. And yes, I did vibe code this.

I am not yet sure of the value of this MCP or AI for training in general. My recent months have been focused on skiing with minimal running. I asked it to help me ease back in to trail running and it came up with a pretty aggressive mileage plan and some heavier threshold work than I am doing now. I'll keep experimenting with it and adding tools as I see fit.

Prerequisites

• Python 3.14+

• uv

• An intervals.icu account with API access

Configuration

Set the following environment variables:

Claude Code Setup

Add to your MCP config (.claude/settings.json or ~/.claude/settings.json):

{
  "mcpServers": {
    "intervals": {
      "command": "env",
      "args": [
        "INTERVALS_ATHLETE_ID=i12345",
        "INTERVALS_API_KEY=your-api-key",
        "uvx", "--from", "/path/to/intervals.mcp", "intervals-mcp"
      ]
    }
  }
}

Claude Desktop Setup

Open the config via Settings → Developer → Edit Config:

{
  "mcpServers": {
    "intervals": {
      "command": "env",
      "args": [
        "INTERVALS_ATHLETE_ID=i12345",
        "INTERVALS_API_KEY=your-api-key",
        "uvx", "--from", "/path/to/intervals.mcp", "intervals-mcp"
      ]
    }
  }
}

Available Tools

Development

uv run intervals-mcp