coros-mcp

A Model Context Protocol (MCP) server that fetches sleep, HRV, and training data from the unofficial Coros API and exposes them to AI assistants like Claude.

No API key required. This server authenticates directly with your Coros Training Hub credentials. Your token is stored securely in your system keyring (or an encrypted local file as fallback), never transmitted anywhere except to Coros.

What You Can Do

Ask your AI assistant questions like:

• "How much deep sleep and REM did I get last week?"
• "What was my HRV trend over the last 4 weeks?"
• "Show me my resting heart rate and training load for last week"
• "How many steps did I average per day this month?"
• "List my rides from last month"
• "Show me the details of my last long ride"
• "Create a 90-minute sweet spot workout for me"
• "What's on my training calendar next week?"
• "Schedule my VO2 workout for Thursday"
• "Create a 20-minute strength circuit with squats, lunges, and planks"

Features

Tool	Description
authenticate_coros	Log in with email and password — token stored securely in keyring
authenticate_coros_mobile	Log in to the mobile API only (useful for sleep data troubleshooting)
check_coros_auth	Check whether a valid auth token is present
get_daily_metrics	Fetch daily metrics (HRV, resting HR, training load, VO2max, stamina, and more) for n weeks (default: 4)
get_sleep_data	Fetch nightly sleep stages (deep, light, REM, awake) and sleep HR for n weeks (default: 4)
list_activities	List activities for a date range with summary metrics
get_activity_detail	Fetch full detail for a single activity (laps, HR zones, power zones)
list_workout_templates	List reusable workout templates saved in the library
save_workout_template	Save a reusable cycling/intervals workout template (named steps, power targets)
save_strength_workout_template	Save a reusable strength workout template (sets, reps, or timed exercises)
delete_workout_template	Delete a saved workout template from the library
list_planned_activities	List planned workouts from the Coros training calendar
schedule_workout	Schedule a one-off cycling/intervals workout for a date (no library entry)
schedule_strength_workout	Schedule a one-off strength workout for a date (no library entry)
schedule_workout_template	Schedule an existing library template on a calendar day
remove_scheduled_workout	Remove a scheduled workout from the calendar
list_exercises	Browse the Coros exercise catalogue, especially for strength workouts
sync_coros_data	Backfill all data into the local SQLite cache for a date range
get_cache_status	Show coverage (record counts and date ranges) of the local cache

---

Setup

Option A: Auto-Setup with Claude Code

If you have Claude Code, paste this prompt:

Set up the Coros MCP server from https://github.com/cygnusb/coros-mcp — clone it, create a venv, install it with pip install -e ., add it to my MCP config, then tell me to run 'coros-mcp auth' in my terminal to authenticate.

Claude will handle the installation and guide you through configuration.

Option B: Manual Setup

Step 1: Install

git clone https://github.com/cygnusb/coros-mcp.git
cd coros-mcp
python3 -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip insta

... [View full README on GitHub](https://github.com/cygnusb/coros-mcp#readme)