Live WHOOP API v2

Hosted WHOOP MCP server

Connect your WHOOP account once and every MCP-capable AI assistant can read your recovery, sleep, strain and workouts. No developer app, no local process, no OAuth setup in your client.

Start 14-day free trial Browse the tools

WHOOP API v2 Read-only scopes Automatic token refresh $39/year

What your assistant can answer

Once connected, these stop being data-export projects and become questions.

“Is my recovery trending up or down this month?”
“Should I do the hard session today, given how I slept?”
“Compare my HRV in weeks I ran over 50 km against weeks I didn't.”
“Which nights had under 90 minutes of deep sleep, and what did I do the day before?”
“Summarise my training load for the last four weeks.”

See worked examples →

YouShould I do intervals today?

Assistant → whoop_recovery({ days: 3 }) · whoop_cycles({ days: 7 })
Today's recovery is 82% with HRV at 111 ms — your best of the week — and yesterday's day strain was only 8.4, so you're not carrying much fatigue. Your last three intervals sessions all came on recovery above 70%, and they went well. Green light.

Tools

What the server exposes

Five WHOOP tools plus a status tool. Each returns markdown, not JSON — fewer tokens and better reasoning.

Tool	Returns	Default window
`whoop_recovery`	Recovery %, resting heart rate, HRV (RMSSD), SpO₂, skin temperature	7 days
`whoop_sleep`	Time asleep, REM / deep / light / awake, performance, efficiency, respiratory rate	7 days
`whoop_workouts`	Sport, strain, duration, avg/max HR, calories, distance	14 days
`whoop_cycles`	Whole-day (wake-to-wake) strain, avg/max HR, calories	7 days
`whoop_profile`	Name, user id, height, weight, max heart rate	—
`fitnesspeak_status`	What's connected and whether the subscription is active	—

Every range-taking tool accepts either days (1–365) or an explicit ISO start/end.

what the model actually receives

## WHOOP Recovery — 2026-08-07 to 2026-08-14 (7 records)

| Date | Recovery | RHR | HRV | SpO2 | Skin temp | Notes |
|---|---|---|---|---|---|---|
| 2026-08-08 | 71% | 48 bpm | 94 ms | 96% | 33.4°C |  |
| 2026-08-09 | 64% | 50 bpm | 81 ms | 96% | 33.6°C |  |
| 2026-08-10 | 43% | 55 bpm | 58 ms | 95% | 34.1°C |  |
| 2026-08-11 | 38% | 57 bpm | 51 ms | 95% | 34.2°C |  |
| 2026-08-12 | 59% | 51 bpm | 74 ms | 96% | 33.7°C |  |
| 2026-08-13 | 78% | 46 bpm | 103 ms | 97% | 33.3°C |  |
| 2026-08-14 | 82% | 45 bpm | 111 ms | 97% | 33.2°C |  |

**Period average:** avg Recovery 62% · avg HRV 82 ms · avg RHR 50 bpm

_Data by WHOOP._

Data by

Install

Two minutes from here to your first answer

Start a trial and connect WHOOP
Sign in with your email — no password. Click Connect WHOOP and approve on WHOOP's consent screen. That is the only OAuth you will ever do.
Copy the URL and key from your dashboard
your dashboard shows both
```
https://fitnesspeak.app/mcp
fp_live_YOUR_KEY_HERE
```

Add it to your client

Claude Code

claude mcp add --transport http fitnesspeak https://fitnesspeak.app/mcp \
  --header "Authorization: Bearer fp_live_YOUR_KEY_HERE"

Claude Desktop, Cursor, Windsurf

{
  "mcpServers": {
    "fitnesspeak": {
      "type": "http",
      "url": "https://fitnesspeak.app/mcp",
      "headers": {
        "Authorization": "Bearer fp_live_YOUR_KEY_HERE"
      }
    }
  }
}

Full per-client guides: Claude · ChatGPT · Cursor · VS Code

Compatibility

Any MCP client that speaks HTTP

Claude Desktop remote MCPClaude Code CLIChatGPT via API / CodexCursor mcp.jsonVS Code CopilotZed context serversWindsurf MCPAny MCP client HTTP

Versus self-hosting

There are free WHOOP MCP servers. Here's the honest trade.

Open-source WHOOP MCP servers exist and work. The difference is what you own afterwards.

	Open-source, self-hosted	FitnessPeak
Register a WHOOP developer app	Yes	No
Copy a client secret into a config file	Yes	No
Keep a process running	Yes	No
Works with your laptop closed	No	Yes
Works in mobile and browser clients	No	Yes
Handles refresh-token rotation	Depends on the project	Yes
Tracks WHOOP API changes for you	No	Yes
Your data never leaves your machine	Yes	No
Cost	Free	$39/yr

We'll say the quiet part. If you want your WHOOP tokens to never leave your own hardware, self-host — that is a real advantage and we can't match it. We wrote the full comparison, including when to pick them over us.

FAQ

WHOOP-specific questions

What is a WHOOP MCP server?

MCP — the Model Context Protocol — is an open standard for giving AI assistants access to tools and data. A WHOOP MCP server exposes your WHOOP metrics as tools an assistant can call, so instead of exporting data you just ask a question and the assistant fetches what it needs.

Does FitnessPeak work with WHOOP API v2?

Yes. FitnessPeak talks to WHOOP's v2 developer API, including the UUID-based sleep and workout identifiers that replaced v1's integers, and the sport_name field that replaced the deprecated sport_id.

Which WHOOP metrics can my assistant see?

Recovery score, resting heart rate, HRV (RMSSD), blood oxygen, skin temperature, time asleep, REM / deep / light / awake stages, sleep performance and efficiency, respiratory rate, per-workout sport, strain, heart rate and calories, whole-day strain, and your profile and body measurements.

Can it write to my WHOOP account or log workouts?

No. Every tool is read-only and FitnessPeak requests only WHOOP's read scopes. There is no write path in the code.

How far back can I query?

Up to 365 days per call. WHOOP returns 25 records per page and FitnessPeak follows pagination up to 500 records per tool call, so a full year of recovery or sleep comes back in one request.

Why is some data missing for certain days?

WHOOP only returns days the strap actually recorded and scored. A day you didn't wear it is absent rather than zero, and a very recent night can come back unscored. FitnessPeak passes that through honestly rather than inventing zeros — and tells the model so it doesn't either.

Does this need my WHOOP password?

Never. You authorise through WHOOP's own OAuth consent screen. FitnessPeak receives a scoped, revocable token and never sees your credentials.

Connect WHOOP to your assistant

14-day free trial. Card required so there's no second signup at the end; cancel before day 14 and you're charged nothing.

Start 14-day trial Read the 2-minute setup

Hosted WHOOP MCP server

What your assistant can answer

What the server exposes

Two minutes from here to your first answer

Start a trial and connect WHOOP

Copy the URL and key from your dashboard

Add it to your client

Any MCP client that speaks HTTP

There are free WHOOP MCP servers. Here's the honest trade.

WHOOP-specific questions

Connect WHOOP to your assistant