A
licenseNot graded
qualityD
maintenanceConnects Whoop health data to Claude via an MCP server, enabling retrieval of recovery, sleep, strain, and workout metrics through natural language tools.
72 npm
MIT
whoop-ai-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@whoop-ai-mcpHow was my recovery today?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Ask More of Your WHOOP Data
Start with a question | Explore |
"How am I doing today?" | Recovery, primary sleep, strain and your latest workout, with missing-data flags. |
"Is my HRV unusual for me?" | Personal baseline distributions, percentiles and sample counts. |
"How did my sleep change this month?" | Trends, period comparisons, observed sleep deficits and consistency. |
"Give me my weekly health review." | Recovery, sleep and training summaries through one conversation. |
Statistics describe your recorded history, not medical diagnoses or predictions.
Related MCP server: whoop-mcp
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
Setup guide · Tool reference · Troubleshooting
Guide | Contents |
Clients, manual configuration, environment variables and WHOOP authorization | |
All tools, parameters, date expressions, resources, prompts and caching | |
Structured results, aggregate mode and assistant-provider disclosure | |
Consent, opt-out, event contract, retention and maintainer dashboard | |
Local diagnostics, common errors and MCP Inspector | |
Docker, cloud hosting and remote connector OAuth | |
Tests, project structure and release workflow | |
Ecosystem research and video walkthrough |
Star History
npm Download History
Build With Us
Found a useful question, a missing workflow or an integration worth sharing? Open an issue or contribute. A GitHub star helps others discover the project.
Contributing · Report a bug · Security policy · Code of Conduct · Changelog
Never include credentials or health records in public reports.
License
MIT. Unofficial project, not affiliated with WHOOP. Membership and API access are separate from this package.
This server cannot be deployed
Maintenance
ActivityActive
ResponsivenessResponsive
Related MCP Connectors
WHOOP recovery, strain, sleep and workouts in Claude via official WHOOP OAuth. Free, open source.
Adaptive running coach MCP server — training data, plans, and recovery for AI assistants.
MCP server for Withings health data — sleep, activity, heart, and body metrics.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceMCP server that connects Whoop fitness data to Claude, enabling natural language queries about recovery, sleep, workouts, and more.-
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that gives Claude access to your WHOOP biometric data — recovery, sleep, strain, and workouts.32 npmMIT
- AlicenseAqualityDmaintenanceMCP server that enables AI assistants to access Whoop health data including recovery, sleep, workouts, and daily strain for personalized health recommendations.772 npmMIT