get_sleep_data

MCP tool from Coros MCP by cygnusb

Fetch nightly sleep stage data for a configurable number of weeks (default: 4).

How to use it

get_sleep_data is exposed by the Coros MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the get_sleep_data tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.

Install Coros MCP

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

FULL COROS MCP LISTING

Other tools in Coros MCP (39)

authenticate_coros

Log in with your Coros credentials. The auth token is stored securely in your system keyring (or an encrypted file as fallback).

authenticate_coros_mobile

Authenticate with the Coros mobile API only. This is mainly useful if you need to restore sleep-data access without redoing full web authentication.

avg_hr

Average heart rate during sleep

avg_sleep_hrv

dayDetail

baseline

dayDetail

check_coros_auth

Check whether valid web and mobile tokens are stored and how long the web token remains valid.

date

—

delete_workout_template

Delete a saved workout template from the Coros library.

get_activity_detail

Fetch full detail for a single activity. Requires the sporttype from listactivities.

get_daily_metrics

Fetch daily metrics for a configurable number of weeks (default: 4).

list_activities

List activities for a date range.

list_planned_activities

List planned activities from the Coros training calendar.

list_workout_templates

List reusable workout templates saved in the Coros library.

lthr

analyse (merge)

ltsp

analyse (merge)

max_hr

Maximum heart rate during sleep

min_hr

Minimum heart rate during sleep

phases.awake_minutes

Time awake during the night

phases.deep_minutes

Deep sleep

phases.light_minutes

Light sleep

phases.nap_minutes

Daytime nap time (null if none)

phases.rem_minutes

REM sleep

quality_score

Sleep quality score (null if not computed)

remove_scheduled_workout

Remove a scheduled workout from the Coros training calendar.

rhr

dayDetail

save_strength_workout_template

Save a reusable strength workout template to the Coros library. Exercises must come from the Coros exercise catalogue.

save_workout_template

Save a reusable cycling/intervals workout template to the Coros library. The template appears in the Coros app and can be synced to the watch. Steps can be plain steps or repeat groups for intervals.

schedule_strength_workout

Schedule a one-off strength workout for a specific date. Builds the workout inline and posts straight to the calendar — does not create a library entry.

schedule_workout

Schedule a one-off cycling/intervals workout for a specific date. Builds the workout inline and posts straight to the calendar — does not create a library entry. This is the common case.

schedule_workout_template

Schedule an existing library template on a calendar day.

stamina_level

analyse (merge)

stamina_level_7d

analyse (merge)

tired_rate

dayDetail

total_duration_minutes

Total sleep in minutes

training_load

dayDetail