whoop-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| WHOOP_MCP_TZ | No | IANA timezone for 'today' and week bounds (default: system zone) | |
| WHOOP_MCP_DIR | No | Directory for tokens, config, exports | ~/.whoop-mcp |
| WHOOP_MCP_DEMO | No | Set to '1' to serve demo data instead of real WHOOP data | |
| WHOOP_CLIENT_ID | No | WHOOP app client ID | |
| WHOOP_MCP_TIMEOUT | No | HTTP timeout in seconds | 30 |
| WHOOP_ACCESS_TOKEN | No | Static token for testing, no refresh | |
| WHOOP_REDIRECT_URI | No | OAuth redirect URI, must match WHOOP dashboard | http://localhost:8765/callback |
| WHOOP_CLIENT_SECRET | No | WHOOP app client secret | |
| WHOOP_MCP_CACHE_TTL | No | Cache TTL in seconds | 60 |
| WHOOP_MCP_LOG_LEVEL | No | Log level (stderr) | INFO |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_profileA | Get the user's WHOOP profile and body measurements (name, email, height, weight, max heart rate). Set include_raw=true to also attach WHOOP's untouched profile and body-measurement records. |
| get_activity_mappingA | Map a legacy WHOOP v1 activity id to its v2 UUID. Useful when older exports, links, or integrations refer to an activity by v1_id. |
| get_daily_summaryA | One day of WHOOP data in a single call: recovery score, sleep, day strain, and workouts, with a one-line summary. The best first tool for "how am I doing" or "how did I sleep" questions. |
| get_weekly_reportA | Monday-to-Sunday report: a per-day grid of recovery, sleep, and strain, plus weekly averages and workout totals. |
| get_recoveriesA | List recovery records (recovery %, HRV, resting heart rate, SpO2, skin temperature), newest first. |
| get_sleepsA | List sleep records (duration, stages, efficiency, performance, sleep debt), newest first. |
| get_sleepA | Get one sleep record by its UUID (from get_sleeps or a recovery's sleep_id). Set include_raw=true to also attach WHOOP's untouched API record. |
| get_workoutsA | List workouts (sport, strain, calories, heart rate, distance, HR zones), newest first. Optionally filter by sport name (substring match, e.g. "run"). |
| get_workoutA | Get one workout by its UUID (from get_workouts). Set include_raw=true to also attach WHOOP's untouched API record. |
| get_cyclesA | List physiological cycles (WHOOP's wake-to-wake "days"): day strain, calories, heart rate. Newest first; the newest cycle is usually still in progress. |
| get_cycleA | Get one cycle by id, optionally with the recovery and sleep that belong to it (WHOOP links each recovery and primary sleep to a cycle). Set include_raw=true to also attach WHOOP's untouched API records. |
| get_recovery_trendsA | Recovery trends over a window (7-180 days): statistics, trend direction, and unusual days for recovery %, HRV, and resting heart rate, plus a daily table. Trend directions account for metric polarity (rising HRV is good, rising resting heart rate is not). |
| get_sleep_trendsA | Sleep trends over a window (7-180 days): hours slept, performance, efficiency, consistency, and sleep debt - statistics, trend directions, unusual nights, and a nightly table. Naps are counted but excluded from nightly averages. |
| get_strain_trendsA | Strain and training-load trends over a window (7-180 days): daily strain statistics, calories, workout totals by sport, and the acute:chronic load ratio (7-day vs 28-day average strain) when enough data exists. |
| compare_periodsA | Compare two date ranges across recovery, HRV, resting heart rate, sleep, strain, calories, and workout count - with per-metric change, percent change, and an improved/declined/unchanged assessment. Period A is the baseline; period B is compared against it. |
| get_health_overviewA | The holistic everything-at-once view (7-180 day window): today's status, recovery/sleep/strain trend directions, training load, personal records and streaks, and the strongest behavior-physiology correlations. The best first call for "give me the full picture of my health". |
| get_correlationsA | How the user's metrics move together day-to-day (7-180 day window): strain vs next-morning recovery, sleep duration vs recovery, sleep consistency vs recovery, strain vs that night's sleep, HRV vs recovery. Pearson r with strength labels and plain-English interpretations - correlation, not causation. |
| get_personal_recordsA | Bests, worsts, and streaks over a window (7-180 days): best/worst recovery, highest HRV, lowest resting heart rate, longest sleep, highest strain day, biggest workout, green-recovery streaks, and totals. |
| get_sleep_streamA | Minute-level overnight sensor data for one sleep: heart rate and skin temperature curves (downsampled to resolution_minutes buckets) plus overnight stats like the lowest heart rate and when it happened. Get the sleep_id from get_sleeps, get_daily_summary, or a recovery record. WHOOP does not expose this stream for every account/app - if unavailable, a clear note is returned instead of an error. Set include_raw=true to also attach WHOOP's untouched stream payload. |
| export_dataA | Export every WHOOP record in a date range to local files on this machine: data.json (complete transformed dataset, plus raw API records when include_raw is true), daily_summary.csv (one row per day), and workouts.csv. Nothing is uploaded anywhere. Returns the file paths and record counts. Large ranges can take a minute or two. |
| get_connection_statusA | Whether this server is connected to a WHOOP account: app credentials, token state and expiry, granted scopes, and a live API check. Call this first when WHOOP data tools fail. |
| connect_whoop_accountA | Connect or re-authorize the user's WHOOP account from inside the chat: opens the WHOOP consent page in the user's browser on this machine and waits up to 3 minutes for them to approve. Only call this when the user explicitly asks to connect, reconnect, or fix authorization. Requires WHOOP app credentials to be configured already (otherwise it returns setup steps instead of opening anything). |
| searchA | Search WHOOP data with a natural-language query (e.g. "sleep last week",
"runs this month", "recovery yesterday"). Returns matching day summaries,
workouts, and sleeps as documents whose ids can be passed to |
| fetchA | Fetch the full document for an id returned by |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| morning_readiness | Assess today's recovery and plan the day around it. |
| weekly_review | Review the last week of recovery, sleep, strain, and training. |
| sleep_coach | Analyze recent sleep and get specific recommendations. |
| training_planner | Evaluate training load and plan the next block. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| resource_profile | The user's WHOOP profile and body measurements. |
| resource_today | Today's combined recovery / sleep / strain / workout summary. |
| resource_latest_recovery | The most recent recovery score. |
| resource_latest_sleep | The most recent sleep record. |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/rajdeepmondaldotcom/whoop-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server