whoop-ai-mcp
A read-only MCP server that brings WHOOP recovery, sleep, HRV, strain and workouts to Claude, Codex and Cursor.
- 181 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The server reads personal health data: sleep, heart rate, HRV, workouts, profile and body measurements.
- Answers land in the context of the model and the assistant cloud.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/whoop-ai-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The server reads personal health data: sleep, heart rate, HRV, workouts, profile and body measurements.
- Answers land in the context of the model and the assistant cloud.
This is third-party code. Review the repository files before installing.
What it does
whoop-ai-mcp connects an assistant to your WHOOP data through the official developer API and writes nothing. You can ask how today is going, how unusual your HRV is, how sleep changed over the month, and get a weekly review of recovery, sleep and training. The standard mode exposes 16 read-only tools: profile and body measurements, collections of recovery, sleep, workouts and cycles (one page, up to 25 records), records by ID, `get_weekly_summary`, `compare_periods`, `get_trend`, `get_today`, `get_baselines` (personal norms with percentiles), `get_sleep_debt` and `get_calendar`. There are extra tools for race preparation (Hyrox, triathlon) and local notes. Aggregate mode narrows the set to five summary tools and hides per-day records. Statistics describe your own history and give no diagnoses or forecasts.
Who it is for. WHOOP owners who want to analyze recovery, sleep and training in Claude, Codex, Cursor, Gemini CLI or VS Code.
Good fit when
- In the morning ask how recovery and sleep compare with your own norm.
- Compare two weeks of sleep and load and look for what changed.
- Request a weekly review of training and recovery in one answer.
- Estimate accumulated sleep debt and routine consistency over a month.
Not a fit when
- A medical assessment is needed: statistics do not replace a diagnosis.
- There is no active WHOOP membership or developer app: without them there is no API access.
- Data must not be shown to the assistant cloud: answers land in the model context.
Example request
How well have I recovered today compared with my norm? Show sleep, HRV and the latest workout and compare with last week.MCP
- Transport
- stdio
- Authentication
- OAuth
Environment variables
WHOOP_CLIENT_IDrequired- WHOOP developer app client ID
WHOOP_CLIENT_SECRETrequired, secret- WHOOP developer app client secret
WHOOP_MCP_PRIVACY_MODE- standard (default) or aggregate
Limitations
Node.js 20 or newer, an active WHOOP membership and a WHOOP developer app with the redirect URL `http://localhost:3000/callback` are required. On first start WHOOP opens in the browser to approve access. Claude web, mobile, ChatGPT and the Grok API need a remote deployment and there are no ready hosted variants. Telemetry is off until you enable it and never includes health data. A Rust version is a separate repository.
How to disable. Remove the whoop entry from the client configuration and revoke the developer app access on the WHOOP side.
FAQ
How do I install whoop-ai-mcp in Claude Code?
Run `npx -y whoop-ai-mcp@latest setup --client=claude-code`, enter the developer app client ID and secret and run the printed registration command.
Does the server write anything to WHOOP?
No, all WHOOP tools only read. Workout notes and race results can be kept locally.
What is aggregate mode?
The `WHOOP_MCP_PRIVACY_MODE=aggregate` mode: five summary tools remain, per-day records are hidden and telemetry is off. It reduces the data shared but does not anonymize it.
Which clients are supported?
Claude Desktop, Claude Code, Codex, GitHub Copilot, Gemini CLI, Cursor, VS Code, OpenClaw and Perplexity on macOS.
Is a WHOOP membership required?
Yes, an active membership and a WHOOP developer app are required, otherwise API access will not open.
Discussion
No questions or reviews yet.
Related
MCP serversAn MCP server that gives an assistant your Whoop data through the app's private API: sleep, recovery, strain, workout logging
coros-mcp (community)
coros-mcp
Unofficial Coros MCP server: sleep, HRV, load and workouts from Training Hub, plus scheduling sessions in the calendar.
Garmin Personal MCP answers questions about sleep, HRV and training from your Garmin Connect account, read-only
An MCP server for workout tracking: Claude Desktop, Cursor and Cline read routines, sets, body weight and 1RM from your self-hosted openGym
Official COROS MCP: an agent reads workouts, sleep and heart rate and drafts training plans saved to your account.
An agent reads sleep, activity and heart data from Fitbit and Pixel Watch over OAuth, with tokens kept on your computer.
README in short
The README explains which questions you can ask, how to install the server with the setup command for various clients, how to create a WHOOP developer app and approve access, and links to the tool reference, the privacy mode and remote deployment.