Recovery, sleep & strain
14 tools for recovery scores, HRV, resting heart rate, sleep stages, daily strain, and workouts, plus weekly summaries, trends, and period comparisons.
Your WHOOP data, in any AI assistant
An MCP server that wraps the WHOOP REST API, so Claude, Cursor, and any MCP client can read your recovery, sleep, strain, and workouts through natural conversation.
npm install -g whoop-ai-mcp
14 tools · 4 resources · 5 prompts · stdio + HTTP transport
MCP-native
Tools, resources, and prompts over stdio or Streamable HTTP. Drop it into Claude Desktop, or host it remotely for any MCP client.
Private by design
Read-only OAuth2 with PKCE. Tokens stay on your machine at
~/.whoop-mcp with 0600 permissions, and the real API is never
touched in tests.
Connect it in one command
The setup wizard writes your client config and verifies your WHOOP credentials in one go. Have your WHOOP Developer App client ID and secret ready from developer.whoop.com.
Claude Desktop
npx whoop-ai-mcp setup
Merges the whoop server into
claude_desktop_config.json (with a .bak backup),
then restart Claude Desktop to load it.
Claude Code
npx whoop-ai-mcp setup --client=claude-code
Prints the equivalent claude mcp add command to register the
server with Claude Code. Add --verify to run the OAuth flow
end-to-end.
Codex
npx whoop-ai-mcp setup --client=codex
Prints a codex mcp add command that registers the server in
your ~/.codex/config.toml for the OpenAI Codex CLI.
GitHub Copilot
npx whoop-ai-mcp setup --client=copilot
Prints a code --add-mcp command to register the server with
GitHub Copilot in VS Code.