intervals-icu-sync

MCP Server — cycling training data from intervals.icu  |  Version 1.2.7

See GitHub repository intervals-icu-sync for details including step-by-step guides how to set up and use the MCP server in popular GenAI platforms.

Endpoints

URLProtocol
https://172.18.0.5:8000/mcpStreamable HTTP (modern)
https://172.18.0.5:8000/sseSSE (legacy)

MCP Methods

MethodDescription
prepare_week_dataRuns the full pipeline and returns consolidated coach input JSON. Supports optional lookback_days (default: 7) for the activity/fueling window while week_summary stays calendar-week based.
get_latest_activitiesReturns a compact latest-first activity list to avoid large payload truncation.
get_activity_streams_sampledReturns a compact, down-sampled stream payload for a single activity. Supports optional stream selection, time/distance windows, and a point cap to keep outputs small.
list_library_workoutsLists the caller's own workout library with library workout ID, duration, TSS and tags. Supports optional filters: tag_prefixes, match_mode (any/all), include_untagged, limit.
validate_week_planValidates plan JSON against contracts/week-plan/week-plan.schema.json and returns structured validation results.
check_plan_tssChecks a generated plan's stated TSS values against deterministic step-based TSS math and weekly target tolerance.
upload_week_planUploads a JSON training plan to intervals.icu (supports dry-run and clear).

Authentication

MethodHow
OAuth 2.0Login via browser — automatic for Claude.ai
Custom headersX-Intervals-Athlete-Id + X-Intervals-Api-Key
URL pathhttps://172.18.0.5:8000/<athlete_id>/<api_key>/mcp

Health check