Intervals MCP

● Active

io.github.ljcl/intervals-mcp

Remote MCP server for intervals.icu run data and analysis

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "intervals-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ljcl/intervals-mcp:3.0.0"
      ],
      "env": {
        "INTERVALS_API_KEY": "<your INTERVALS_API_KEY>",
        "ORS_API_KEY": "<your ORS_API_KEY>",
        "HOME_START": "<your HOME_START>",
        "MCP_AUTH_TOKEN": "<your MCP_AUTH_TOKEN>"
      }
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --env INTERVALS_API_KEY='<your INTERVALS_API_KEY>' --env ORS_API_KEY='<your ORS_API_KEY>' --env HOME_START='<your HOME_START>' --env MCP_AUTH_TOKEN='<your MCP_AUTH_TOKEN>' --transport stdio intervals-mcp -- docker run -i --rm ghcr.io/ljcl/intervals-mcp:3.0.0
OpenAI Codex CLI
codex mcp add intervals-mcp --env INTERVALS_API_KEY='<your INTERVALS_API_KEY>' --env ORS_API_KEY='<your ORS_API_KEY>' --env HOME_START='<your HOME_START>' --env MCP_AUTH_TOKEN='<your MCP_AUTH_TOKEN>' -- docker run -i --rm ghcr.io/ljcl/intervals-mcp:3.0.0
VS Code
code --add-mcp '{"name":"intervals-mcp","type":"stdio","command":"docker","args":["run","-i","--rm","ghcr.io/ljcl/intervals-mcp:3.0.0"],"env":{"INTERVALS_API_KEY":"<your INTERVALS_API_KEY>","ORS_API_KEY":"<your ORS_API_KEY>","HOME_START":"<your HOME_START>","MCP_AUTH_TOKEN":"<your MCP_AUTH_TOKEN>"}}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

Environment variables
  • INTERVALS_API_KEYrequiredsecretintervals.icu personal API key (Settings, Developer Settings)
  • ORS_API_KEYsecretOpenRouteService API key (openrouteservice.org) for generated route suggestions; unset offers past runs only
  • HOME_STARTsecretUsual run start as lat,lng (e.g. 37.79,-122.39); unset infers it from recent GPS runs
  • MCP_AUTH_TOKENsecretShared secret (32+ characters) gating /mcp and detailed /health (recommended when internet-facing)

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Other
Version
3.0.0
Registry
active
Published
11/19/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks healthy: Intervals MCP is maintained, open source.

Maintained
Active
Last commit 6 days ago (Nov 15, 2026), 8 open issues.
Official registry
Active
Published as io.github.ljcl/intervals-mcp in the official MCP registry, version 3.0.0.
Source
Open source, MIT
Public repository under the MIT licence, 0 stars, 0 forks.
Runs
On your machine
A local Docker package started by your client; it can reach whatever your user account can.
Credentials
4 required
Declared environment variables: INTERVALS_API_KEY, ORS_API_KEY, HOME_START, MCP_AUTH_TOKEN. They stay on your machine; the config on this page shows where each goes.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself.

On GitHub

read Nov 17, 2026
Stars
0
Forks
0
Last push
Nov 15, 2026
License
MIT

TypeScript

From the README

Intervals Extra (intervals-mcp) A single-user remote MCP server for intervals.icu run data and analysis, with interactive MCP Apps. All text tools and every MCP App talk to intervals.icu directly and are verified against a real account; see docs/tools.md for the full catalog. Configuration is checked at startup: a bad variable stops the server with a message naming it, and the key's presence is reported on /health. History. This project began as strava-mcp and was migrated to intervals.icu as its data source; nothing in the server talks to Strava today. Setup 1. Get an intervals.icu API key 1. Log in to intervals.icu 2. Go to Settings, Developer Settings 3. Copy your personal API key 2. Configure environment Edit .env with your values: All variables are listed in docs/operations.md. 3. Run it Local development (needs Bun): Docker: Compose publishes the port on 127.0.0.1 only, which is all a tunnel needs. To reach the server from other machines on your LAN, set BIND_ADDR=0.0.0.0 in .env, and set MCPAUTHTOKEN too (operations.md). Prefer the prebuilt image? Pull ghcr.io/ljcl/intervals-mcp:latest, the newest release (also on the MCP registry as io.github.ljcl/intervals-mcp), and point your compose image: at it instead of building; you still supply your own API key. :edge tracks unreleased main.…

Read the full README on GitHub →

The most-starred Other servers in the index, with their live-check result.

ServerStarsLast pushLive check
Labelhead Artist Momentum114,594Nov 2026Working
World Monitor91,002Nov 2026Needs sign-in
Tldraw51,470Nov 2026Working
OpenSEO28,515Nov 2026Needs sign-in
Windows MCP11,833Nov 2026Local / not checked

Intervals MCP: questions people ask

Is Intervals MCP a remote or a local MCP server?
According to its entry in the official MCP registry, Intervals MCP ships as a local package (Docker) that your client starts on your machine.
Does Intervals MCP need an API key?
Its registry entry declares 4 required environment variables: INTERVALS_API_KEY, ORS_API_KEY, HOME_START, MCP_AUTH_TOKEN. The config on this page shows where each goes.
Is Intervals MCP safe to use?
Looks healthy: Intervals MCP is maintained, open source. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: On your machine; credentials: 4 required. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is Intervals MCP still maintained?
Active: the repository's last commit 6 days ago. Last push Nov 15, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 17, 2026.
How do I add Intervals MCP to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
  1. Gaggiuino MCPRemote MCP server for your Gaggiuino espresso machine's shots and profiles★ 1
  2. Strava MCPRemote MCP server for your Strava activities, segments, and routes
Browse all Other →

Add the badge to your site

Show visitors that Intervals MCP is listed here — it’s also the link we check for a free listing.

Intervals MCP — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-ljcl-intervals-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Intervals MCP — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Intervals MCP — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-ljcl-intervals-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-ljcl-intervals-mcp) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-ljcl-intervals-mcp) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-ljcl-intervals-mcp)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-ljcl-intervals-mcp"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-ljcl-intervals-mcp"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-ljcl-intervals-mcp"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).