Whoop's official API is 13 read-only endpoints. I wrapped the private one the app actually uses with 48 tools. Free and open source.

[u/ultrarunnerr]

Whoop's official API (OAuth 2.0) is 13 read-only endpoints: recovery score, sleep totals, a workout list. The app shows you 24x more and none of the good parts are reachable programmatically. So I reverse-engineered the private API the iOS app actually uses and wrapped it as an MCP server. Plug it into Claude (Desktop, web, mobile, or code), or any AI that accepts MCP and your entire Whoop account becomes something you can query and act on in plain English.

It allows you to use basically the whole app surface including 48 tools across 47 microservices:

- Recovery, not just the score, but HRV, resting HR, respiratory rate, SpO₂, skin temp, and a one-call daily overview.

- Sleep, minute by minute, the full hypnogram (REM/light/deep/wake timeline + in-sleep heart rate), sleep need & debt, sleep performance, the sleep coach.

- Strain & cardio, day strain, calories, live HR, live activity state, configurable HR zones (set your max HR + 5 custom zones), VO₂ max.

- Strength Trainer with every set across your history, PRs, volume/progression, the exercise library, custom exercises, saved templates.

- Journal & behaviors, a 308-behavior journal with Whoop's own behavior-impact analysis (and Claude can analyze it itself), plus symptom logging and autofill.

- Stress, the intraday stress timeline and a live stress read.

- Trends & analysis across 25 metrics over multiple windows, week-vs-week / month-vs-month compare, a performance assessment, the calendar grid.

- Plus Whoop Coach AI chat, women's health (cycle phase + insights), community leaderboards, smart alarm, profile/body measurements, and hidden metrics.

Bundled catalogs (372 exercises, 308 behaviors, 203 sports, 311 endpoints mapped) mean the AI queries with real IDs, not guesses. And for anything I didn't wrap into a dedicated tool, there are two escape hatches, search the endpoint catalog, then call any of the 311 endpoints directly.

The MCP writes, not just reads. It can log workouts, add journal entries, edit your profile, reconfigure your smart alarm, change HR zones, all from your chat. Every write is preview-gated: it shows you the exact payload before sending, and nothing fires without your confirmation.

Setup is one command. The guided CLI runs the Whoop login (SMS MFA included) end to end, you just pick how you run it:

- whoop-mcp cloud → deploys to a host (Fly automated, or Railway / Cloud Run / Docker), generates its secrets, and connects it to Claude as a custom connector that syncs across web, desktop, and mobile.

- whoop-mcp local → runs on your machine over stdio for Claude Desktop / Claude Code. No hosting, this device only.

The 2-minute demo above is that whole cloud flow, untouched: install → login → deploy → connector → first query.

The project is built in TypeScript, every response schema-validated, so if Whoop changes something it fails cleanly instead of feeding the model garbage. Auth auto-refreshes (~30-day tokens). 212 tests. Works with any MCP client, Claude Code, ChatGPT Desktop, Codex, Gemini CLI, Cursor. The project is fully open-source and I actively push changes, if Whoop changes their API, I will immediately push a fix for it.

Free, open source, live on npm + the MCP registry:

- npm: briangaoo/whoop-mcp

- registry: io.github.briangaoo/whoop-mcp

- github: github.com/briangaoo/whoop-mcp