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_workouts	List all saved structured workout programs
create_workout	Create a new structured workout with named steps and power targets
delete_workout	Delete a workout program from the library
list_planned_activities	List planned workouts from the Coros training calendar
schedule_workout	Schedule an existing workout on a calendar day
remove_scheduled_workout	Remove a scheduled workout from the calendar
create_strength_workout	Create a structured strength workout with sets, reps, or timed exercises
list_exercises	Browse the Coros exercise catalogue, especially for strength workouts

---

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 install -e .

Or with uv:

uv pip install -e .

Step 2: Add to Claude Code

claude mcp add coros -- /path/to/coros-mcp/.venv/bin/coros-mcp serve

To limit the MCP to a specific project only (recommended):

cd /path/to/your/project
claude mcp add --scope project coros -- /path/to/coros-mcp/.venv/bin/coros-mcp serve

Or add to Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "coros": {
      "command": "/path/to/coros-mcp/.venv/bin/coros-mcp",
      "args": ["serve"]
    }
  }
}

Step 3: Authenticate

Option A — .env file (recommended for project-scoped setups):

Create a .env file in your project directory:

COROS_EMAIL=you@example.com
COROS_PASSWORD=yourpassword
COROS_REGION=eu

The server authenticates automatically on the first request and re-authenticates transparently whenever th

... View full README on GitHub