intervals-icu-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
intervals-icu-mcp
Read-only access to your Intervals.icu training data and deterministic endurance analytics through MCP. For developers and technically proficient athletes who want AI-assisted reviews grounded in their own records.
Self-host one private instance per owner. Use your own Cloudflare account, Intervals credentials and GitHub OAuth app. Maintainers do not host athlete data or collect credentials. Existing wearable synchronization stays external. MIT licensed; not affiliated with Intervals.icu or wearable manufacturers.
Features and architecture
Ten read-only tools: profile, activities/details, fitness, wellness, calendar, summaries and three deterministic analyses.
Sport-neutral volume/load comparisons; running-first efficiency proxies and comparable workouts.
Explicit units, athlete-local dates, source/computed provenance and missing-data/coverage reporting.
Optional English/Indonesian Training Analyst Skill for workout, weekly, trend and race-preparation reviews.
Mandatory owner OAuth, Streamable HTTP, request limits and server-side Workers Secrets.
flowchart TD
Platforms[Wearables and training platforms] --> Intervals[Intervals.icu]
Repository[Public repository] --> Worker[Your Cloudflare Worker]
Repository --> Skill[Portable Training Analyst Skill]
Client[Your AI client] -->|Owner OAuth and Streamable HTTP| Worker
Worker --> Tools[Read-only data tools and deterministic analytics]
Tools --> API[Intervals API client and normalization]
API -->|Server-side credentials| Intervals
Skill -->|Workflows and interpretation| Client
Worker --> KV[Owner-specific OAuth KV]The API client, portable domain/analytics, MCP transport and authentication are separate modules. No athlete database, write operations, background jobs, telemetry collection or coaching engine.
Related MCP server: intervals-mcp
Quick start
Requires Node.js 22.14+ or 24 LTS and pnpm 10.34.9.
git clone https://github.com/rbernanda/intervals-icu-mcp.git
cd intervals-icu-mcp
pnpm install --frozen-lockfile
pnpm check
pnpm verify:runtime
pnpm run doctorChecks use synthetic data and need no credentials. Doctor is offline unless given a URL; absent account checks are NOT_TESTED. Follow quick start for a complete first installation.
Deploy your private server
Follow self-hosting or the step-by-step onboarding runbook. Create your GitHub OAuth app and owner-specific KV, run pnpm setup:deploy, enter secrets with Wrangler's hidden prompts, dry-run pnpm build:instance, then explicitly run pnpm deploy:instance when ready. Configuration uses an ignored file; no TypeScript edits.
INTERVALS_API_KEY, INTERVALS_ATHLETE_ID and GITHUB_CLIENT_SECRET remain Workers Secrets. See the complete configuration inventory. For local live development use pnpm setup:local and pnpm dev; OAuth remains mandatory.
Wrangler CLI is the supported deployment path. A Deploy to Cloudflare button is deferred until its per-owner OAuth/secrets flow is verified; see the evaluation. Build commands do not deploy.
AI Training Analyst Skill
The server retrieves/validates data and computes analytics. The optional skill selects workflows/tools and interprets evidence. Installing it does not deploy, authenticate or connect the server.
pnpm skill:install --agent codex --project ../my-training-project
pnpm run doctor --agent codex --project ../my-training-projectUse --agent claude-code or --agent cursor for those clients. The installer copies the entire canonical package, records version/checksum, protects existing edits and supports explicit --update. This repository retains its one canonical Codex symlink. See installation and updates.
Invoke $intervals-training-analyst Analyze my latest running activity. in Codex; Claude Code and Cursor use their documented slash skill selection. A local skill folder does not install a skill into hosted ChatGPT.
Connect and verify your client
Guides: Codex · Claude Code · Cursor · ChatGPT Custom MCP Server.
Use your deployed HTTPS /mcp endpoint with OAuth. Prefer CIMD; enable DCR explicitly only if your client requires it. GitHub sign-in verifies the one configured numeric owner ID; every private request checks token audience, expiry, scope and owner. Do not supply Intervals credentials to the AI client. A Codex connection is separate from ChatGPT-mode registration.
See the dated compatibility matrix: portable resource tests and local Inspector success do not prove a live client/account connection. For safe endpoint checks use doctor, then privately confirm your athlete profile and one activity against Intervals. Follow the synthetic first-insight example.
Tools
Tool | Purpose / principal inputs |
| Configured athlete profile; no arguments |
| Optional inclusive dates, sport and limit 1–100; default 20 / last 28 days |
| Activity ID; optional intervals (no raw streams) |
| Inclusive dates; source CTL/ATL and labeled computed form |
| Inclusive dates; available HRV, resting HR, sleep and subjective metrics |
| Inclusive dates; events and explicitly paired completed activities |
| Days 7/14/28/42/90, optional sport; coverage-aware totals |
| Non-overlapping current/baseline date ranges, optional sport |
| Dates and athlete-designated steady-aerobic running IDs |
| Dates, optional IDs/category/reference/settings; limit 2–20 |
Deterministic Analytics — v0.2
Three analytical tools move arithmetic from the LLM into pure tested functions. Volume/load comparisons support multiple sports with explicit filtering. Running is the first sport-specific adapter; other efficiency/comparability sports return unsupported results. Source CTL/ATL, load and efficiency fields stay distinct from computed aggregates and the speed/HR proxy. The skill prefers analytical tools when available and discloses older-server fallbacks.
Dates are inclusive athlete-local YYYY-MM-DD, at most 90 days per range. Units are meters, seconds, m/s, seconds/km, bpm, watts and kilograms; running cadence retains source rpm and explicitly derives spm. Missing metrics remain null; partial load is a known subtotal, not a complete total. API success does not establish synchronization coverage. No daily source TSB is documented: same-day CTL − ATL is explicitly computed, not authoritative source Form. Efficiency proxies are observational, not laboratory running economy, drift or race predictions. See methods, settings and limitations.
Example questions
“Review my latest run.” “Compare my last seven completed days with the preceding seven.” “Compare my last five long runs.” “How have fitness and fatigue changed over six weeks?” “Review my half-marathon preparation.” Ask for date ranges, units, provenance and data gaps. Missing wellness never proves recovery; negative form never proves overtraining.
Security, maintenance and contributing
Never commit keys, filled-in environment files, instance configuration, tokens or real athlete exports. Treat retrieved names/notes as untrusted data. Security policy covers token lifetime, revocation, rotation and limitations. GitHub/Cloudflare account protection remains the owner's responsibility.
Upgrades, rollback and release checklist · Changelog · Troubleshooting · Validation evidence · Contributing · MIT License · Dependency notices.
The portable-distribution milestone is released as 1.2.0 because v1.0.0/v1.1.0 already exist. No existing tags are replaced. See the dated validation evidence for deployment and client verification boundaries.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect Intervals.icu to Claude and ChatGPT: read training, plan workouts. Training never stored.
Connect Claude to your Intervals.icu watch data for fitness, workout review, and plan writing.
Garmin data in Claude & ChatGPT via the Garmin Health API. OAuth sign-in, no password sharing.
tri-train is a training platform for triathletes that syncs activities from Strava and Garmin and exposes them to Claude through a remote MCP server. Ask Claude how your last block went, why your run pace dropped, or whether you are fresh enough for Sunday's race, and it answers from your real data: activities with laps and grade-adjusted pace, weekly load and the performance management chart (CTL/ATL/TSB), sleep, HRV and resting heart rate, and your race calendar with predictions. Claude can also act: create and adjust planned workouts with structured intervals, push them to your Garmin watch, add races and write notes. Every change is journaled and can be undone. Read and write access are separate OAuth scopes, and the server enforces them on every call. Built and hosted in Switzerland by a triathlete; data stays on our own servers (Swiss revDSG / GDPR).
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server that connects Claude and ChatGPT to the Intervals.icu API, enabling retrieval and management of activities, events, wellness data, power curves, and custom items.21GPL 3.0
- AlicenseAqualityDmaintenanceProvides AI assistants with read-only access to an athlete's Intervals.icu training data, including activities, wellness metrics, zones, and planned events, for use with MCP clients like ChatGPT and Claude.15MIT
- AlicenseNot gradedqualityBmaintenanceEnables users to connect ChatGPT or remote MCP clients to their own Garmin cloud health and activity data through a self-hosted, read-only OAuth-protected Cloudflare Worker.238 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables a single owner to query their intervals.icu training data — athlete profile and recent activities — from ChatGPT through an OAuth-protected, read-only connection. It authenticates the owner via GitHub sign-in and exposes a read-only toolset with no write, delete, or coach capabilities.Apache 2.0