Whoop MCP server
io.github.shashankswe2020-ux/whoop·v0.5.2·158 starsMCP server for WHOOP health data — recovery, sleep, workouts, cycles, and trends.
158 stars1.3k downloads/wk
Reviews
Write oneNobody has reviewed Whoop yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Whoop tools (14)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
compare_periodsCompare health metrics between two time periods — shows improvement or regression in recovery, sleep, and strain.
get_body_measurementGet the user's body measurements — height, weight, and max heart rate.
get_calendarGet a day-by-day grid of recovery, sleep, and strain for a date range. Perfect for weekly/monthly overviews.
get_cycle_by_idGet a single physiological cycle by its ID. Returns strain, calories, and heart rate data.
get_cycle_collectionGet physiological cycles for a date range. Accepts ISO 8601 or relative dates ("today", "last 7 days", "this week"). Returns strain, calories, and heart rate data per cycle.
get_profileGet the authenticated user's basic profile — name and email.
get_recovery_collectionGet recovery scores for a date range. Accepts ISO 8601 or relative dates ("today", "last 7 days", "this week"). Returns HRV, resting heart rate, SpO2, and skin temp for each day.
get_sleep_by_idGet a single sleep record by its ID. Returns sleep stages, duration, respiratory rate, and performance scores.
get_sleep_collectionGet sleep records for a date range. Accepts ISO 8601 or relative dates ("today", "last 7 days", "this week"). Returns sleep stages, duration, respiratory rate, and performance scores.
get_todayGet today's complete health snapshot — recovery score, last night's sleep, current strain, and last workout in one call.
get_trendAnalyze a health metric trend over time — detects direction (improving/declining/stable), variability, and anomalies using linear regression.
get_weekly_summaryGet a summarized health report for a given week — average recovery, HRV, RHR, sleep duration and quality, workout count and strain, plus recovery trend direction.
get_workout_by_idGet a single workout record by its ID. Returns strain, heart rate zones, calories, and sport type.
get_workout_collectionGet workout records for a date range. Accepts ISO 8601 or relative dates ("today", "last 7 days", "this week"). Returns strain, heart rate zones, calories, and sport type.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan73 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 2 days ago15/15
- Maintainer identityregistry namespace matches repository owner6/10
How Whoop compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 80/100
- higher than 60% of 48,255 servers
- Tools
- 14
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 158
- more than 95% of 28,688 servers
- Downloads a week
- 1,256
- more than 95% of 12,191 servers with a package
What its tools let an agent do: 14 read
Install Whoop in Claude Code, Cursor or VS Code
Runs npx -y whoop-ai-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add whoop -- npx -y whoop-ai-mcp
What the publisher says
From the Whoop repository's README, as published. We do not edit it. Read it on GitHub
WHOOP MCP
Your WHOOP data. A conversation away. Recovery, sleep, HRV and training trends in the AI assistant you already use.
Try it now · Watch the walkthrough · Explore the docs · Latest release
whoop-ai-mcp is a read-only WHOOP MCP server for Claude Desktop, Claude Code, Codex and GitHub Copilot. Ask about your recovery, compare weeks of sleep, or explore your personal baseline without exporting and assembling the data yourself.
Earlier Claude Desktop demo. The assistant creates the presentation; this server supplies the data. Results and layout vary.
16 read-only tools · 4 resources · 5 prompt templatesStandard mode. Client support for resources, prompts and remote connections varies.
Ask More of Your WHOOP Data
Statistics describe your recorded history, not medical diagnoses or predictions.
Quickstart
You need Node.js 20+, an active WHOOP membership, and a WHOOP Developer App with the redirect URL http://localhost:3000/callback.
npx -y whoop-ai-mcp@latest setup --client=claude-desktopSet up. Authorize. Ask. Enter your app credentials, then fully quit and reopen Claude Desktop. Authorize WHOOP in your browser on first server start and ask:
"Summarize my sleep and recovery this week."
Optional telemetry defaults to No. No global npm installation is needed.
For Claude Code, Codex or Copilot, use --client=claude-code, --client=codex or --client=copilot, then run the registration command setup prints. Full setup and configuration.
Your Data, Your Choice
Read-only WHOOP access. Local by default. No hosted relay required.
Health results reach the assistant provider you configure. Aggregate mode limits disclosure to five summary tools; it is not anonymization. Usage telemetry is off by default and requires consent; it never includes health data or chat text. Opted-in tool failures use fixed coarse categories without raw error messages, response bodies or identifiers. See data handling and telemetry controls.
Documentation
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Whoop: common questions
- Is Whoop MCP server safe?
- Mostly: it is graded B (80/100). Read the Whoop safety report
- How do I install Whoop?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Whoop need an API key?
- Yes. The registry entry asks for
WHOOP_CLIENT_ID,WHOOP_CLIENT_SECRET. - Is Whoop maintained?
- The last commit was 40 days ago (2026-09-25). The latest release is v0.5.2.
- How does Whoop compare with other MCP servers?
- safety score 80/100 (higher than 60% of 48,255 servers); tools 14 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.