Skip to content
Back to search

intervals-icu-mcp

Read/write MCP server for Intervals.icu — training data, planning, and structured workout generation.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/hhopke/intervals-icu-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/hhopke/intervals-icu-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hhopke--intervals-icu-mcp/badge.svg)](/listings/hhopke--intervals-icu-mcp)

HTML

<a href="/listings/hhopke--intervals-icu-mcp"><img src="/api/listings/hhopke--intervals-icu-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

<a href="https://cursor.com/en/install-mcp?name=intervals-icu&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJpbnRlcnZhbHMtaWN1LW1jcCJdLCJlbnYiOnsiSU5URVJWQUxTX0lDVV9BUElfS0VZIjoiIiwiSU5URVJWQUxTX0lDVV9BVEhMRVRFX0lEIjoiIn19"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/deeplink/mcp-install-dark.svg"><img alt="Install in Cursor" src="https://cursor.com/deeplink/mcp-install-light.svg"></picture></a>

Or for Claude Desktop, in 30 seconds:

1. Get your [API key and athlete ID](#intervalsicu-api-key-setup) 2. Add this to your Claude Desktop config:

{
  "mcpServers": {
    "intervals-icu": {
      "command": "uvx",
      "args": ["intervals-icu-mcp"],
      "env": {
        "INTERVALS_ICU_API_KEY": "your-api-key-here",
        "INTERVALS_ICU_ATHLETE_ID": "i123456"
      }
    }
  }
}

3. Restart Claude and ask *"Show me my activities from the last 7 days."*

Prefer Claude Code, Cursor, or ChatGPT? See [Client Configuration](#client-configuration). Want to run from source or with Docker? See [Installation & Setup](#installation--setup).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 275 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <!-- mcp-name: io.github.hhopke/intervals-icu-mcp -->
  2. # Intervals.icu MCP Server
  3. ![intervals-icu-mcp demo](https://raw.githubusercontent.com/hhopke/intervals-icu-mcp/main/docs/demo.gif)
  4. A Model Context Protocol (MCP) server for Intervals.icu integration. Access your training data, wellness metrics, and performance analysis through Claude, ChatGPT, and other LLMs.
  5. > Originally based on [eddmann/intervals-icu-mcp](https://github.com/eddmann/intervals-icu-mcp) (MIT licensed). This project is an independent continuation with significant bug fixes and new features — see the [release notes](https://github.com/hhopke/intervals-icu-mcp/releases) for details.
  6. [![Tests](https://github.com/hhopke/intervals-icu-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/hhopke/intervals-icu-mcp/actions/workflows/test.yml)
  7. [![intervals-icu-mcp MCP server](https://glama.ai/mcp/servers/hhopke/intervals-icu-mcp/badges/score.svg)](https://glama.ai/mcp/servers/hhopke/intervals-icu-mcp)
  8. [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/hhopke/intervals-icu-mcp/blob/main/LICENSE)
  9. [![Docker](https://img.shields.io/badge/docker-ghcr.io-blue?logo=docker)](https://github.com/hhopke/intervals-icu-mcp/pkgs/container/intervals-icu-mcp)
  10. [![Sponsor](https://img.shields.io/badge/sponsor-%E2%9D%A4-ff69b4?logo=githubsponsors)](https://github.com/sponsors/hhopke)
  11. ## Overview
  12. 73 tools spanning activities, activity analysis, activity messages, athlete profile, wellness, events/calendar, performance curves, workout library, gear, sport settings, and custom items — plus 4 MCP Resources (athlete profile, workout syntax, event categories, custom item schemas) and 9 MCP Prompts (training analysis, recovery check, weekly planning, and more). See [Available Tools](#available-tools) for the per-category breakdown.
  13. ## Quick Start
  14. <a href="https://cursor.com/en/install-mcp?name=intervals-icu&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJpbnRlcnZhbHMtaWN1LW1jcCJdLCJlbnYiOnsiSU5URVJWQUxTX0lDVV9BUElfS0VZIjoiIiwiSU5URVJWQUxTX0lDVV9BVEhMRVRFX0lEIjoiIn19"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/deeplink/mcp-install-dark.svg"><img alt="Install in Cursor" src="https://cursor.com/deeplink/mcp-install-light.svg"></picture></a>
  15. Or for Claude Desktop, in 30 seconds:
  16. 1. Get your [API key and athlete ID](#intervalsicu-api-key-setup)
  17. 2. Add this to your Claude Desktop config:
  18. ```json
  19. {
  20. "mcpServers": {
  21. "intervals-icu": {
  22. "command": "uvx",
  23. "args": ["intervals-icu-mcp"],
  24. "env": {
  25. "INTERVALS_ICU_API_KEY": "your-api-key-here",
  26. "INTERVALS_ICU_ATHLETE_ID": "i123456"
  27. }
  28. }
  29. }
  30. }
  31. ```
  32. 3. Restart Claude and ask *"Show me my activities from the last 7 days."*
  33. Prefer Claude Code, Cursor, or ChatGPT? See [Client Configuration](#client-configuration). Want to run from source or with Docker? See [Installation & Setup](#installation--setup).
  34. ## Prerequisites
  35. Install [uv](https://github.com/astral-sh/uv) — it handles Python, dependencies, and execution in one tool. `curl -LsSf https://astral.sh/uv/install.sh | sh` on macOS/Linux (or `brew install uv`; Homebrew no longer installs on Intel Macs), or `powershell -c "irm https://astral.sh/uv/install.ps1 | iex"` on Windows. From there, `uvx` fetches Python and the package automatically. If your MCP client can't find `uvx`, set `command` to the full path that `which uvx` prints. Docker is also supported as an alternative.
  36. ## Intervals.icu API Key Setup
  37. Before installation, obtain your Intervals.icu API key:
  38. 1. Go to https://intervals.icu/settings → **Developer** → **Create API Key**.
  39. 2. Copy the key, and note your **Athlete ID** from your profile URL (format: `i123456`).
  40. ## Installation & Setup
  41. **Nothing to install separately if you use the recommended setup.** `uvx` (which ships with `uv`) automatically downloads and caches the `intervals-icu-mcp` package the first time your MCP client launches it — just paste the config snippet from [Client Configuration](#client-configuration) into your client and you're done.
  42. <details>
  43. <summary><b>Alternative: from source</b> — for development or local modifications</summary>
  44. ```bash
  45. git clone https://github.com/hhopke/intervals-icu-mcp.git
  46. cd intervals-icu-mcp
  47. uv sync
  48. uv run intervals-icu-mcp-auth # interactive credential setup; or create .env manually:
  49. # INTERVALS_ICU_API_KEY=your_api_key_here
  50. # INTERVALS_ICU_ATHLETE_ID=i123456
  51. ```
  52. Then point your MCP client at this checkout — see the **From source** snippet inside each client below.
  53. </details>
  54. <details>
  55. <summary><b>Alternative: Docker</b></summary>
  56. ```bash
  57. docker build -t intervals-icu-mcp .
  58. # Interactive credential setup (creates intervals-icu-mcp.env in the current directory):
  59. touch intervals-icu-mcp.env # pre-create the file so Docker mounts it as a file, not a dir
  60. docker run -it --rm \
  61. -v "$(pwd)/intervals-icu-mcp.env:/app/.env" \
  62. --entrypoint= intervals-icu-mcp:latest \
  63. python -m intervals_icu_mcp.scripts.setup_auth
  64. ```
  65. Or create `intervals-icu-mcp.env` manually (same format as the `.env` above).
  66. Then point your MCP client at the Docker image — see the **Docker** snippet inside each client below.
  67. </details>
  68. ## Client Configuration
  69. The server speaks MCP over stdio and works with any compliant client. Click a client to expand. If you followed Quick Start (uvx), use the first config block; if you used the source or Docker alternative above, use the matching variant inside the same collapsible.
  70. <details>
  71. <summary><b>Claude Desktop</b></summary>
  72. Add to your configuration file:
  73. - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
  74. - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
  75. ```json
  76. {
  77. "mcpServers": {
  78. "intervals-icu": {
  79. "command": "uvx",
  80. "args": ["intervals-icu-mcp"],
  81. "env": {
  82. "INTERVALS_ICU_API_KEY": "your-api-key-here",
  83. "INTERVALS_ICU_ATHLETE_ID": "i123456"
  84. }
  85. }
  86. }
  87. }
  88. ```
  89. **From source** (requires `git clone` + `uv sync` + `uv run intervals-icu-mcp-auth`):
  90. ```json
  91. {
  92. "mcpServers": {
  93. "intervals-icu": {
  94. "command": "uv",
  95. "args": ["run", "--directory", "/ABSOLUTE/PATH/TO/intervals-icu-mcp", "intervals-icu-mcp"]
  96. }
  97. }
  98. }
  99. ```
  100. **Docker**:
  101. ```json
  102. {
  103. "mcpServers": {
  104. "intervals-icu": {
  105. "command": "docker",
  106. "args": ["run", "-i", "--rm", "-v", "/ABSOLUTE/PATH/TO/intervals-icu-mcp.env:/app/.env", "intervals-icu-mcp:latest"]
  107. }
  108. }
  109. }
  110. ```
  111. </details>
  112. <details>
  113. <summary><b>Claude Code</b></summary>
  114. Register the server as a user-scoped MCP server:
  115. ```bash
  116. claude mcp add intervals-icu --scope user \
  117. --env INTERVALS_ICU_API_KEY=your-key \
  118. --env INTERVALS_ICU_ATHLETE_ID=i123456 \
  119. -- uvx intervals-icu-mcp
  120. ```
  121. Then in any Claude Code session, run `/mcp` to confirm `intervals-icu` is connected.
  122. </details>
  123. <details>
  124. <summary><b>Cursor</b></summary>
  125. Add to `~/.cursor/mcp.json` (or the project-local `.cursor/mcp.json`):
  126. ```json
  127. {
  128. "mcpServers": {
  129. "intervals-icu": {
  130. "command": "uvx",
  131. "args": ["intervals-icu-mcp"],
  132. "env": {
  133. "INTERVALS_ICU_API_KEY": "your-api-key-here",
  134. "INTERVALS_ICU_ATHLETE_ID": "i123456"
  135. }
  136. }
  137. }
  138. }
  139. ```
  140. Restart Cursor and open *Settings → MCP* to verify the server is listed.
  141. </details>
  142. <details>
  143. <summary><b>ChatGPT</b> — requires a paid plan, Developer Mode, and a publicly reachable URL <em>(walkthrough not yet verified end-to-end)</em></summary>
  144. ChatGPT's custom MCP connector flow requires running the server over HTTP and exposing it via a tunnel, then registering the URL in ChatGPT's Developer Mode settings. See [docs/chatgpt-connector.md](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/chatgpt-connector.md) for the full walkthrough, plan-tier requirements, and security notes.
  145. </details>
  146. ## Usage
  147. Ask Claude to interact with your Intervals.icu data in natural language. A few starter prompts:
  148. ```
  149. "Show me my activities from the last 30 days"
  150. "Am I overtraining? Check my CTL, ATL, and TSB"
  151. "How's my recovery this week? Show HRV and sleep trends"
  152. "Create a sweet spot cycling workout for tomorrow"
  153. "What's my 20-minute power and FTP?"
  154. ```
  155. For the full catalogue of example prompts by category, see [docs/examples.md](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/examples.md).
  156. ## Available Tools
  157. 73 tools, 4 resources, and 9 prompt templates. One-line summary below — full reference in [docs/tools.md](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/tools.md).
  158. | Category | Tools | Summary |
  159. |---|---|---|
  160. | [Activities](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/tools.md#activities-13-tools) | 13 | Query, search, update, delete, download activities |
  161. | [Activity Analysis](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/tools.md#activity-analysis-9-tools) | 9 | Streams, window stats, intervals, best efforts, histograms |
  162. | [Activity Messages](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/tools.md#activity-messages-4-tools) | 4 | Read, post, edit, and delete notes/comments/coach feedback on activities |
  163. | [Athlete](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/tools.md#athlete-5-tools) | 5 | Accessible athletes, profile and athlete notes, CTL/ATL/TSB analysis, fitness chart time-series |
  164. | [Wellness](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/tools.md#wellness-3-tools) | 3 | HRV, sleep, recovery metrics |
  165. | [Events / Calendar](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/tools.md#events--calendar-13-tools) | 13 | Planned workouts, races, notes, ATP periodization (bulk ops supported) |
  166. | [Performance / Curves](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/tools.md#performance--curves-3-tools) | 3 | Power, HR, and pace curves with zones |
  167. | [Workout Library](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/tools.md#workout-library-8-tools) | 8 | Browse, create, and delete folders and training plans; create (incl. bulk), update, and delete library workouts |
  168. | [Gear Management](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/tools.md#gear-management-6-tools) | 6 | Track equipment and maintenance reminders |
  169. | [Sport Settings](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/tools.md#sport-settings-4-tools) | 4 | FTP, FTHR, pace thresholds, and zones |
  170. | [Custom Items](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/tools.md#custom-items-5-tools) | 5 | User customizations: custom charts, fields, zones, dashboard panels |
  171. ## Delete Safety Mode
  172. Destructive tools are gated by the optional `INTERVALS_ICU_DELETE_MODE` env var (`safe` / `full` / `none`, default `safe`) — a server-side gate outside the model's reach, so unregistered tools can't be invoked. See [docs/tools.md](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/tools.md#delete-safety-mode) for the full mode table, response envelope, and TZ-buffer rationale.
  173. ## Remote Deployment (HTTP / SSE)
  174. The server runs over **stdio** by default — the right transport for local clients like Claude Desktop, Claude Code, and Cursor. HTTP and SSE transports are available for remote or hosted use.
  175. > ⚠️ MCP has **no built-in authentication** — never expose an HTTP-mode server to an untrusted network without a tunnel (Tailscale, Cloudflare Tunnel) or an authenticating reverse proxy.
  176. See [docs/remote-deployment.md](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/remote-deployment.md) for transport flags and the full security model.
  177. ## Documentation
  178. - [Example prompts](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/examples.md) — full catalogue of natural-language prompts by category
  179. - [Tool reference](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/tools.md) — complete tool, resource, and prompt inventory
  180. - [Architecture overview](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/architecture.md) — how the server, middleware, client, and tools fit together
  181. - [Remote deployment (HTTP/SSE)](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/remote-deployment.md) — transports, flags, and the security model for hosted/remote setups
  182. - [Testing guide](https://github.com/hhopke/intervals-icu-mcp/blob/main/docs/testing.md) — conventions for pytest + respx, fixtures, and running the suite
  183. - [Releases](https://github.com/hhopke/intervals-icu-mcp/releases) — release notes ([CHANGELOG.md](CHANGELOG.md) covers releases up to 5.8.0)
  184. - [Adding a new tool](https://github.com/hhopke/intervals-icu-mcp/blob/main/.claude/skills/add-tool/SKILL.md) — step-by-step workflow for contributors
  185. ## Feedback
  186. **How are you using this?** Which tools you lean on, what your prompts look like, where it gets in your way — that shapes the roadmap more than my own guesses do.
  187. [Show and tell](https://github.com/hhopke/intervals-icu-mcp/discussions/categories/show-and-tell) · [Q&A](https://github.com/hhopke/intervals-icu-mcp/discussions/categories/q-a) · [Ideas](https://github.com/hhopke/intervals-icu-mcp/discussions/categories/ideas) · [General](https://github.com/hhopke/intervals-icu-mcp/discussions/categories/general) — or [open an issue](https://github.com/hhopke/intervals-icu-mcp/issues/new/choose) for a reproducible bug.
  188. ## Contributing
  189. **Contributions are very welcome, and none is too small** — a typo, a clearer parameter description, an extra test, a whole new tool. No Python or MCP expertise assumed. See [CONTRIBUTING.md](https://github.com/hhopke/intervals-icu-mcp/blob/main/CONTRIBUTING.md); in short, run `make can-release` before opening a PR. [Good first issues](https://github.com/hhopke/intervals-icu-mcp/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) are a gentle place to start.
  190. ## Sponsor
  191. Free under the MIT License, maintained in my spare time. If it's useful to you, [GitHub Sponsors](https://github.com/sponsors/hhopke) supports continued development — entirely optional, and feedback or a PR helps just as much.
  192. ## License
  193. MIT License - see the [LICENSE](https://github.com/hhopke/intervals-icu-mcp/blob/main/LICENSE) file for details.
  194. ## Disclaimer
  195. This project is not affiliated with, endorsed by, or sponsored by Intervals.icu. All product names, logos, and brands are property of their respective owners.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.