Whoop Mcp
@JedPattersonn
MCP server for WHOOP - integrate your fitness and biometric data with Claude and other LLMs
Overview
What is Whoop Mcp?
A Model Context Protocol (MCP) server that enables access to Whoop fitness biometric data, integrating it into Claude, LLMs, and other MCP-compatible applications.
How to use Whoop Mcp?
Clone the repository, set WHOOP_EMAIL and WHOOP_PASSWORD in a .env file, install dependencies with bun install, and start the server with bun run start. For Docker, build the image and run the container. Credentials can also be provided as query parameters when deployed via Smithery. Add the server to Claude Desktop using the provided JSON configuration.
Key features of Whoop Mcp?
- Comprehensive daily metrics overview
- Sleep analysis with performance scores
- Recovery metrics including HRV and RHR
- Strain tracking with heart rate zones
- Healthspan analysis (biological age)
Use cases of Whoop Mcp?
- Check a daily Whoop overview with live metrics and activities
- Analyze sleep performance and get personalized insights
- Review recovery score and its contributors (HRV, RHR, etc.)
- Monitor strain score and heart rate zone breakdown
- Track biological age and pace of aging trends
FAQ from Whoop Mcp?
What do I need to run the server?
You need a Bun runtime, your Whoop email and password (set as environment variables or query parameters), and optionally Docker for containerized deployment.
How does the server handle authentication?
The server logs in with your Whoop credentials on the first request, stores the access token in memory (valid 24 hours), and automatically re-authenticates before the token expires.
Can I secure the server with an authentication token?
Yes, set the MCP_AUTH_TOKEN environment variable. All requests to /mcp must then include a Bearer token in the Authorization header.
What tools are available?
Five tools: whoop_get_overview, whoop_get_sleep, whoop_get_recovery, whoop_get_strain, and whoop_get_healthspan. Each takes an optional date parameter and returns structured Whoop data.
Can I deploy on Smithery?
Yes, the server includes a smithery.yaml file. When deployed on Smithery, credentials are passed as query parameters (whoopEmail, whoopPassword).
