whoop — Claude Code MCP server: what it does, how to install
Connects WHOOP health metrics to your AI client, surfacing daily recovery, sleep debt, strain, and baseline trends.
claude mcp add whoop -e WHOOP_CLIENT_ID=<WHOOP_CLIENT_ID> -e WHOOP_CLIENT_SECRET=<WHOOP_CLIENT_SECRET> -- npx -y whoop-ai-mcpWhat whoop does
The integration brings 16 read-only utilities directly into your developer assistant. It fetches strain scores, workout logs, sleep cycles, and recovery percentages so you can query your health history conversationally.
Everything executes on your local machine using the whoop-ai-mcp package without intermediary relay hosts. Setup requires registering a project in the WHOOP developer portal with http://localhost:3000/callback set as the redirect address, then passing your credentials via environment flags.
Without a current WHOOP subscription and Node.js version 20 or higher, the server fails to authenticate. The returned data reflects historical measurements rather than medical evaluations.
What it helps with
- check today's strain score and recovery balance
- evaluate HRV percentiles against personal baselines
- track sleep debt changes across multiple weeks
- compile a consolidated weekly training recap
Example prompts for the agent
- How am I doing today based on my recovery and strain?
- Compare my sleep consistency over the last month.
- Give me a breakdown of my workouts and rest from this past week.
How to install whoop
Platform CLI
claude mcp add whoop -e WHOOP_CLIENT_ID=<WHOOP_CLIENT_ID> -e WHOOP_CLIENT_SECRET=<WHOOP_CLIENT_SECRET> -- npx -y whoop-ai-mcpReplace <…> with your own values
Platform CLI
codex mcp add whoop --env WHOOP_CLIENT_ID=<WHOOP_CLIENT_ID> --env WHOOP_CLIENT_SECRET=<WHOOP_CLIENT_SECRET> -- npx -y whoop-ai-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"whoop": {
"command": "npx",
"args": [
"-y",
"whoop-ai-mcp"
],
"env": {
"WHOOP_CLIENT_ID": "<WHOOP_CLIENT_ID>",
"WHOOP_CLIENT_SECRET": "<WHOOP_CLIENT_SECRET>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"whoop": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"whoop-ai-mcp"
],
"env": {
"WHOOP_CLIENT_ID": "<WHOOP_CLIENT_ID>",
"WHOOP_CLIENT_SECRET": "<WHOOP_CLIENT_SECRET>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e WHOOP_CLIENT_ID=<WHOOP_CLIENT_ID> -e WHOOP_CLIENT_SECRET=<WHOOP_CLIENT_SECRET> whoop npx -y whoop-ai-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about whoop
How do I install whoop in Claude Code?
Execute claude mcp add whoop -e WHOOP_CLIENT_ID=<WHOOP_CLIENT_ID> -e WHOOP_CLIENT_SECRET=<WHOOP_CLIENT_SECRET> -- npx -y whoop-ai-mcp. Replace the placeholder variables with your credentials from developer.whoop.com.
What does the whoop MCP server do?
It exposes read-only endpoints to inspect your personal fitness telemetry, such as sleep debt, HRV baselines, and workout history. The assistant reads metrics on demand without editing your profile.
What prerequisites are required to run whoop?
You must have an environment running Node.js 20 or above, a valid WHOOP account membership, and registered developer credentials with http://localhost:3000/callback. On launch, a browser window prompts you to approve access.
