io.github.rajdeepmondaldotcom/whoop-mcp-server
PYPI · WHOOP-MCP-SERVER · SCANNED SEP 20
WHOOP recovery, sleep, strain, and workouts for any AI. Analysis tools, demo mode, fast setup.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security100
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- Runs hatchling.build at install time, a recognised native-build step with no shell scripting around it. View diagnostics → Pass
- 0 of 29 dependencies flagged as unhealthy. View diagnostics → Pass
Provenance & Transparency35
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- License check failed: no license is declared. See how to fix → Fail
- Actively maintained (last published 99 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability86
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- Tool/resource definitions use about 2369 tokens (~84/item across 28 items; 24 tools + 4 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management87
- Stability observed for 26 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage71
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 0% of tool parameters carry a description.Fail
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 24 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 26 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the io.github.rajdeepmondaldotcom/whoop-mcp-server server?
io.github.rajdeepmondaldotcom/whoop-mcp-server runs locally as a PyPI package, launched with uvx whoop-mcp-server. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
pypi · whoop-mcp-server
claude mcp add rajdeepmondaldotcom-whoop-mcp-server -- uvx whoop-mcp-server
{
"mcpServers": {
"rajdeepmondaldotcom-whoop-mcp-server": {
"command": "uvx",
"args": [
"whoop-mcp-server"
]
}
}
} {
"servers": {
"rajdeepmondaldotcom-whoop-mcp-server": {
"command": "uvx",
"args": [
"whoop-mcp-server"
]
}
}
} codex mcp add rajdeepmondaldotcom-whoop-mcp-server -- uvx whoop-mcp-server
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"rajdeepmondaldotcom-whoop-mcp-server": {
"type": "local",
"command": [
"uvx",
"whoop-mcp-server"
],
"enabled": true
}
}
} openclaw mcp add rajdeepmondaldotcom-whoop-mcp-server --command uvx --arg whoop-mcp-server
mcp_servers:
rajdeepmondaldotcom-whoop-mcp-server:
command: "uvx"
args: ["whoop-mcp-server"] {
"McpServers": {
"rajdeepmondaldotcom-whoop-mcp-server": {
"Transport": "stdio",
"Command": "uvx",
"Arguments": [
"whoop-mcp-server"
]
}
}
} assistant mcp add rajdeepmondaldotcom-whoop-mcp-server -t stdio -c uvx -a whoop-mcp-server
{
"mcpServers": {
"rajdeepmondaldotcom-whoop-mcp-server": {
"command": "uvx",
"args": [
"whoop-mcp-server"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 19 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.
- 18 Sept 26 +12
- Malware scan: unverified → pass ▲ security
- Stability: pass → 0.80 functional
- 17 Sept 26 0
- Stability: 0.97 → pass security
- 16 Sept 26 −14
- Malware scan: pass → unverified ▼ security
- 14 Sept 26 +16
- Malware scan: unverified → pass ▲ security
- 12 Sept 26 −2
- Stability: pass → 0.83 functional
- 11 Sept 26 0
- Stability: 0.97 → pass security
- 10 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Analysed pypi/whoop-mcp-server@0.0.12
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | pypi |
Background: How many MCP packages publish verified provenance →
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| build_backend | allowlisted | hatchling.build |
Background: Why install scripts are a supply-chain risk →
Dependencies 29 packages
| Packages resolved | 29 |
|---|---|
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
compare_periods Compare periods ~156
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.
| Name | Type | Req | Description |
|---|---|---|---|
| period_a_end | string | yes | – |
| period_a_start | string | yes | – |
| period_b_end | string | yes | – |
| period_b_start | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
connect_whoop_account Connect WHOOP account ~94
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).
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
export_data Export all WHOOP data ~127
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.
| Name | Type | Req | Description |
|---|---|---|---|
| end | string | – | – |
| include_raw | boolean | – | – |
| start | string | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
fetch Fetch WHOOP document ~57
Fetch the full document for an id returned by `search`. Supported id forms: day:YYYY-MM-DD, sleep:<uuid>, workout:<uuid>, cycle:<int>, recovery:<cycle_int>, profile.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_activity_mapping Activity ID mapping ~53
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.
| Name | Type | Req | Description |
|---|---|---|---|
| activity_v1_id | integer | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_connection_status WHOOP connection status ~48
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.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
get_correlations Behavior correlations ~80
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.
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_cycle Cycle by id ~86
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.
| Name | Type | Req | Description |
|---|---|---|---|
| cycle_id | integer | yes | – |
| include_raw | boolean | – | – |
| include_recovery | boolean | – | – |
| include_sleep | boolean | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_cycles List cycles ~102
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.
| Name | Type | Req | Description |
|---|---|---|---|
| end | – | – | – |
| limit | integer | – | – |
| start | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_daily_summary Daily summary ~82
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.
| Name | Type | Req | Description |
|---|---|---|---|
| day | string | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_health_overview Health overview ~79
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".
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_personal_records Personal records & streaks ~71
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.
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_profile WHOOP profile ~59
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.
| Name | Type | Req | Description |
|---|---|---|---|
| include_raw | boolean | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_recoveries List recoveries ~92
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.
| Name | Type | Req | Description |
|---|---|---|---|
| end | – | – | – |
| limit | integer | – | – |
| start | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_recovery_trends Recovery trends ~76
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).
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_sleep Sleep by id ~58
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.
| Name | Type | Req | Description |
|---|---|---|---|
| include_raw | boolean | – | – |
| sleep_id | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_sleep_stream Sleep sensor stream ~135
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.
| Name | Type | Req | Description |
|---|---|---|---|
| include_raw | boolean | – | – |
| resolution_minutes | integer | – | – |
| sleep_id | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_sleep_trends Sleep trends ~68
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.
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_sleeps List sleeps ~95
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.
| Name | Type | Req | Description |
|---|---|---|---|
| end | – | – | – |
| include_naps | boolean | – | – |
| limit | integer | – | – |
| start | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_strain_trends Strain & training load ~69
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.
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_weekly_report Weekly report ~67
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).
| Name | Type | Req | Description |
|---|---|---|---|
| week_of | string | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_workout Workout by id ~52
Get one workout by its UUID (from get_workouts). Set include_raw=true to also attach WHOOP's untouched API record.
| Name | Type | Req | Description |
|---|---|---|---|
| include_raw | boolean | – | – |
| workout_id | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_workouts List workouts ~108
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.
| Name | Type | Req | Description |
|---|---|---|---|
| end | – | – | – |
| limit | integer | – | – |
| sport | – | – | – |
| start | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
search Search WHOOP data ~63
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`.
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
What is the io.github.rajdeepmondaldotcom/whoop-mcp-server server?
io.github.rajdeepmondaldotcom/whoop-mcp-server is listed in the public MCP registry as io.github.rajdeepmondaldotcom/whoop-mcp-server. WHOOP recovery, sleep, strain, and workouts for any AI. Analysis tools, demo mode, fast setup. This page covers its PyPI package (whoop-mcp-server).
Is the io.github.rajdeepmondaldotcom/whoop-mcp-server server safe to use?
io.github.rajdeepmondaldotcom/whoop-mcp-server scores 80 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.rajdeepmondaldotcom/whoop-mcp-server server expose?
io.github.rajdeepmondaldotcom/whoop-mcp-server exposes 24 tools: get_profile, get_activity_mapping, get_daily_summary, get_weekly_report, get_recoveries, and 19 more. Their descriptions and schemas cost roughly 1,977 tokens of context every time the server is loaded.
Is the io.github.rajdeepmondaldotcom/whoop-mcp-server server still maintained?
io.github.rajdeepmondaldotcom/whoop-mcp-server is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.