Whoop
by shashankswe2020-uxcommunityv0.2.1
57
13
An MCP server that connects AI assistants to WHOOP health and fitness data via OAuth2. It exposes tools for accessing profile, body measurements, recovery, sleep, workouts, and cycles data.
From the registry: MCP server for WHOOP health data — recovery, sleep, workouts, cycles, and more.
Install & configure
Prerequisites
- requiredWHOOP account with active membershipYou need a WHOOP account with an active membership to access your health and fitness data.https://www.whoop.com/
- requiredWHOOP Developer AppCreate a WHOOP Developer App and configure its redirect URI to http://localhost:3000/callback. The README also instructs enabling scopes: read:profile, read:recovery, read:sleep, read:workout, read:cycles, and read:body_measurement, then copying the client ID and client secret.https://developer.whoop.com
- requiredNode.js >= 20Install Node.js version 20 or newer so the server can be run via npx.https://nodejs.org/
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `whoop` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **WHOOP account with active membership** — You need a WHOOP account with an active membership to access your health and fitness data. (https://www.whoop.com/)
- **WHOOP Developer App** — Create a WHOOP Developer App and configure its redirect URI to http://localhost:3000/callback. The README also instructs enabling scopes: read:profile, read:recovery, read:sleep, read:workout, read:cycles, and read:body_measurement, then copying the client ID and client secret. (https://developer.whoop.com)
- **Node.js >= 20** — Install Node.js version 20 or newer so the server can be run via npx. (https://nodejs.org/)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["whoop-ai-mcp"]
- required environment variables:
- `WHOOP_CLIENT_ID`: Your WHOOP Developer App client ID. (example: `<your-client-id>`)
- `WHOOP_CLIENT_SECRET`: Your WHOOP Developer App client secret. (example: `<your-client-secret>`)
Note: On first run, the server opens a browser for OAuth2 authorization with WHOOP. Tokens are cached at ~/.whoop-mcp/tokens.json and refreshed automatically. Although WHOOP_REDIRECT_URI appears in the MCP Inspector example, the main installation/configuration docs only require WHOOP_CLIENT_ID and WHOOP_CLIENT_SECRET for normal MCP client usage.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: On first run, the server opens a browser for OAuth2 authorization with WHOOP. Tokens are cached at ~/.whoop-mcp/tokens.json and refreshed automatically. Although WHOOP_REDIRECT_URI appears in the MCP Inspector example, the main installation/configuration docs only require WHOOP_CLIENT_ID and WHOOP_CLIENT_SECRET for normal MCP client usage.
Tools (6)
get_profile
Get the authenticated user's basic profile, including name and email.
get_body_measurement
Get the user's body measurements, including height, weight, and max heart rate.
get_recovery_collection
Get recovery scores for a date range, including HRV, resting heart rate, SpO2, and skin temperature.
get_sleep_collection
Get sleep records for a date range, including sleep stages, duration, respiratory rate, and performance scores.
get_workout_collection
Get workout records for a date range, including strain, heart rate zones, calories, and sport type.
get_cycle_collection
Get physiological cycles for a date range, including strain, calories, and heart rate data per cycle.
Environment variables
WHOOP_CLIENT_IDrequiredWHOOP Developer App client ID used for OAuth authentication.WHOOP_CLIENT_SECRETrequiredWHOOP Developer App client secret used for OAuth authentication.Prerequisites
- • Node.js >= 20
Packages
whoop-ai-mcp
npmv0.2.1transport: stdio
Details
- Language
- TypeScript
- License
- MIT
- Released
- Apr 16, 2026
- Last commit
- May 1, 2026
- Registry name
- io.github.shashankswe2020-ux/whoop