Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
WHOOP_MCP_TZNoIANA timezone for 'today' and week bounds (default: system zone)
WHOOP_MCP_DIRNoDirectory for tokens, config, exports~/.whoop-mcp
WHOOP_MCP_DEMONoSet to '1' to serve demo data instead of real WHOOP data
WHOOP_CLIENT_IDNoWHOOP app client ID
WHOOP_MCP_TIMEOUTNoHTTP timeout in seconds30
WHOOP_ACCESS_TOKENNoStatic token for testing, no refresh
WHOOP_REDIRECT_URINoOAuth redirect URI, must match WHOOP dashboardhttp://localhost:8765/callback
WHOOP_CLIENT_SECRETNoWHOOP app client secret
WHOOP_MCP_CACHE_TTLNoCache TTL in seconds60
WHOOP_MCP_LOG_LEVELNoLog level (stderr)INFO

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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.

`day` accepts: today | yesterday | N days ago | YYYY-MM-DD.
get_weekly_reportA

Monday-to-Sunday report: a per-day grid of recovery, sleep, and strain, plus weekly averages and workout totals.

`week_of` accepts: this week | last week | YYYY-MM-DD (any day in the
target week).
get_recoveriesA

List recovery records (recovery %, HRV, resting heart rate, SpO2, skin temperature), newest first.

Defaults to the last 14 days when no range is given. `start`/`end` accept:
today | yesterday | N days ago | last week | YYYY-MM-DD | ISO datetime.
get_sleepsA

List sleep records (duration, stages, efficiency, performance, sleep debt), newest first.

Defaults to the last 14 days when no range is given. `start`/`end` accept:
today | yesterday | N days ago | last week | YYYY-MM-DD | ISO datetime.
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").

Defaults to the last 30 days when no range is given. `start`/`end` accept:
today | yesterday | N days ago | last week | YYYY-MM-DD | ISO datetime.
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.

Defaults to the last 14 days when no range is given. `start`/`end` accept:
today | yesterday | N days ago | last week | YYYY-MM-DD | ISO datetime.
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.

All four arguments accept: today | yesterday | N days ago | last week |
this month | YYYY-MM-DD | ISO datetime. Example: compare "last month" to
"this month" by using the same expression for a period's start and end.
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.

`start`/`end` accept: N years ago | N months ago | YYYY-MM-DD | ISO datetime.
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 fetch.

fetchA

Fetch the full document for an id returned by search. Supported id forms: day:YYYY-MM-DD, sleep:, workout:, cycle:, recovery:, profile.

Prompts

Interactive templates invoked by user choice

NameDescription
morning_readinessAssess today's recovery and plan the day around it.
weekly_reviewReview the last week of recovery, sleep, strain, and training.
sleep_coachAnalyze recent sleep and get specific recommendations.
training_plannerEvaluate training load and plan the next block.

Resources

Contextual data attached and managed by the client

NameDescription
resource_profileThe user's WHOOP profile and body measurements.
resource_todayToday's combined recovery / sleep / strain / workout summary.
resource_latest_recoveryThe most recent recovery score.
resource_latest_sleepThe 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