Whoop MCP

Name: Whoop MCP
Author: AshwanthramKL

by AshwanthramKLversion 0.8.5i★ 0iRuns on your computer

Registry nameio.github.AshwanthramKL/whoop-mcp

How to install

What it does

Read-only WHOOP v2 data for MCP clients, with local SQLite cache and CSV/JSONL/Parquet exports.

Connects Runs on your computer
Account or key Needs WHOOP_CLIENT_SECRET · 1 setting to fill in (WHOOP_CLIENT_ID)
Category Databases & datasets

Install

Pick the AI app you use, then copy the settings.

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

ClaudeWeb · app · phoneChatGPTWebClaude CodeTerminalCursorCode editorVS CodeCode editorOtherOther apps

Pick your app and the steps appear below.

Works with Claude, with some setup first

You need a Whoop MCP key (create it on the maker’s site) · 1 setting(s) to fill in (WHOOP_CLIENT_ID) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Install Python (uv)
One time only; it works for every server that needs Python (uv)
Open the Python (uv) download page ↗
Done
Sign up and create a Whoop MCP key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
Done
3
Fill in 1 setting(s)
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
- WHOOP_CLIENT_ID Client ID from your WHOOP developer app (https://developer-dashboard.whoop.com/apps/create).
Descriptions are as written by the maker.
Done
Open the Claude desktop app’s settings file
SettingsDeveloperEdit Config
Done

Paste these settings and save the file

{
  "mcpServers": {
    "whoop": {
      "command": "uvx",
      "args": [
        "whoop-mcp"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "your-value",
        "WHOOP_CLIENT_SECRET": "your-value"
      }
    }
  }
}

Paste the key only into the app’s field, never into a chat or to anyone

Done

Quit Claude and open it again
Done
Try it
Use Whoop MCP and tell me what you can do for me, then show me one thing
✓ If Claude says it is using Whoop MCP or shows a Whoop MCP tool in the answer, you are connected

4 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

WHOOP_REDIRECT_URI OAuth redirect URI. Defaults to http://localhost:8000/callback — only change if you registered a different URI. · default http://localhost:8000/callback
WHOOP_LOG_LEVEL Log level (DEBUG / INFO / WARNING / ERROR). Default INFO. · default INFO
WHOOP_LOG_FILE Path to the rotating log file. Set to empty string to disable file logging. Default ~/.whoop-mcp-server/logs/whoop-mcp.log.
WHOOP_LOG_JSON Structured JSON logs (true) vs human-readable (false). Default true. · default true

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Whoop MCP yet

Whoop MCP runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Whoop MCP

Steps for Claude →You need a Whoop MCP key (create it on the maker’s site) · 1 setting(s) to fill in (WHOOP_CLIENT_ID) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Steps for Claude Code →You need a Whoop MCP key (create it on the maker’s site) · 1 setting(s) to fill in (WHOOP_CLIENT_ID) · Install Python (uv) on your computer first (one time)
Steps for Cursor →You need a Whoop MCP key (create it on the maker’s site) · 1 setting(s) to fill in (WHOOP_CLIENT_ID) · Install Python (uv) on your computer first (one time)
Steps for VS Code →You need a Whoop MCP key (create it on the maker’s site) · 1 setting(s) to fill in (WHOOP_CLIENT_ID) · Install Python (uv) on your computer first (one time)

B · Others in Databases & datasets that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Supabase✓ ChatGPT
Appwrite MCP✓ ChatGPT
Pg Aiguide✓ ChatGPT

Works with Claude Code, with some setup first

You need a Whoop MCP key (create it on the maker’s site) · 1 setting(s) to fill in (WHOOP_CLIENT_ID) · Install Python (uv) on your computer first (one time)

Install Python (uv)
One time only; it works for every server that needs Python (uv)
Open the Python (uv) download page ↗
Done
Sign up and create a Whoop MCP key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
Done
3
Fill in 1 setting(s)
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
- WHOOP_CLIENT_ID Client ID from your WHOOP developer app (https://developer-dashboard.whoop.com/apps/create).
Descriptions are as written by the maker.
Done
Open Terminal
Mac: press Command+Space and type Terminal · Windows: open PowerShell
Done
5
Paste this command and press Enter
```
claude mcp add --scope user whoop --env WHOOP_CLIENT_ID=your-value --env WHOOP_CLIENT_SECRET=your-value -- uvx whoop-mcp
```
Replace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
Done
Type /mcp in Claude Code
You should see Whoop MCP listed as connected
Done
Try it
Use Whoop MCP and tell me what you can do for me, then show me one thing
✓ If Claude Code says it is using Whoop MCP or shows a Whoop MCP tool in the answer, you are connected

4 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

WHOOP_REDIRECT_URI OAuth redirect URI. Defaults to http://localhost:8000/callback — only change if you registered a different URI. · default http://localhost:8000/callback
WHOOP_LOG_LEVEL Log level (DEBUG / INFO / WARNING / ERROR). Default INFO. · default INFO
WHOOP_LOG_FILE Path to the rotating log file. Set to empty string to disable file logging. Default ~/.whoop-mcp-server/logs/whoop-mcp.log.
WHOOP_LOG_JSON Structured JSON logs (true) vs human-readable (false). Default true. · default true

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

You need a Whoop MCP key (create it on the maker’s site) · 1 setting(s) to fill in (WHOOP_CLIENT_ID) · Install Python (uv) on your computer first (one time)

Install Python (uv)
One time only; it works for every server that needs Python (uv)
Open the Python (uv) download page ↗
Done
Sign up and create a Whoop MCP key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
Done
3
Fill in 1 setting(s)
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
- WHOOP_CLIENT_ID Client ID from your WHOOP developer app (https://developer-dashboard.whoop.com/apps/create).
Descriptions are as written by the maker.
Done
Click this button to open Cursor
Open in Cursor
Cursor asks you to confirm; click Install
Done
Fill in your key
In the Whoop MCP settings, WHOOP_CLIENT_SECRET, WHOOP_CLIENT_ID is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Done
Open the AI chat in Cursor in Agent mode
Done
Try it
Use Whoop MCP and tell me what you can do for me, then show me one thing
✓ If Cursor says it is using Whoop MCP or shows a Whoop MCP tool in the answer, you are connected

4 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

WHOOP_REDIRECT_URI OAuth redirect URI. Defaults to http://localhost:8000/callback — only change if you registered a different URI. · default http://localhost:8000/callback
WHOOP_LOG_LEVEL Log level (DEBUG / INFO / WARNING / ERROR). Default INFO. · default INFO
WHOOP_LOG_FILE Path to the rotating log file. Set to empty string to disable file logging. Default ~/.whoop-mcp-server/logs/whoop-mcp.log.
WHOOP_LOG_JSON Structured JSON logs (true) vs human-readable (false). Default true. · default true

Descriptions are as written by the maker.

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

You need a Whoop MCP key (create it on the maker’s site) · 1 setting(s) to fill in (WHOOP_CLIENT_ID) · Install Python (uv) on your computer first (one time)

Install Python (uv)
One time only; it works for every server that needs Python (uv)
Open the Python (uv) download page ↗
Done
Sign up and create a Whoop MCP key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
Done
3
Fill in 1 setting(s)
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
- WHOOP_CLIENT_ID Client ID from your WHOOP developer app (https://developer-dashboard.whoop.com/apps/create).
Descriptions are as written by the maker.
Done
Click this button to open VS Code
Open in VS Code
VS Code asks you to confirm; click Install
Done
Fill in your key
In the Whoop MCP settings, WHOOP_CLIENT_SECRET, WHOOP_CLIENT_ID is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Done
Open the AI chat in VS Code in Agent mode
Done
Try it
Use Whoop MCP and tell me what you can do for me, then show me one thing
✓ If VS Code says it is using Whoop MCP or shows a Whoop MCP tool in the answer, you are connected

4 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

WHOOP_REDIRECT_URI OAuth redirect URI. Defaults to http://localhost:8000/callback — only change if you registered a different URI. · default http://localhost:8000/callback
WHOOP_LOG_LEVEL Log level (DEBUG / INFO / WARNING / ERROR). Default INFO. · default INFO
WHOOP_LOG_FILE Path to the rotating log file. Set to empty string to disable file logging. Default ~/.whoop-mcp-server/logs/whoop-mcp.log.
WHOOP_LOG_JSON Structured JSON logs (true) vs human-readable (false). Default true. · default true

Descriptions are as written by the maker.

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Whoop MCP💬 Discussion →

For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user whoop --env WHOOP_CLIENT_ID=your-value --env WHOOP_CLIENT_SECRET=your-value -- uvx whoop-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "whoop": {
      "command": "uvx",
      "args": [
        "whoop-mcp"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "your-value",
        "WHOOP_CLIENT_SECRET": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "whoop": {
      "command": "uvx",
      "args": [
        "whoop-mcp"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "your-value",
        "WHOOP_CLIENT_SECRET": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "whoop": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "whoop-mcp"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "your-value",
        "WHOOP_CLIENT_SECRET": "your-value"
      }
    }
  }
}

Values you fill in

WHOOP_CLIENT_ID required env
Client ID from your WHOOP developer app (https://developer-dashboard.whoop.com/apps/create).
WHOOP_CLIENT_SECRET secret required env
Client secret from your WHOOP developer app. Used for OAuth token refresh.
WHOOP_REDIRECT_URI env
OAuth redirect URI. Defaults to http://localhost:8000/callback — only change if you registered a different URI.
WHOOP_LOG_LEVEL env
Log level (DEBUG / INFO / WARNING / ERROR). Default INFO.
WHOOP_LOG_FILE env
Path to the rotating log file. Set to empty string to disable file logging. Default ~/.whoop-mcp-server/logs/whoop-mcp.log.
WHOOP_LOG_JSON env
Structured JSON logs (true) vs human-readable (false). Default true.

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

GitHub stars i: 0
Downloads per weeki: 74/wk
Licence i: MIT
Connection: Runs on your computer
Transport: stdio
Latest versioni: 0.8.5
Categoryi: Databases & datasets
Published to registryi: Apr 25, 2026
Code last changedi: Jul 13, 2026
Maker: AshwanthramKL
Packages: pypi: whoop-mcp
Repo: AshwanthramKL/whoop-mcp
Registry status: Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

All apps, with pros and cons →

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 14, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account AshwanthramKL, which owns the repo
✓ Pass
Still maintained
Code last changed 4 months ago
✓ Pass
Has a licence
Uses MIT
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

User reviews

No reviews yet

Compared with others in Databases & datasetsi

More stars than 0% of the other 1194 servers in this category
Published to the registry more recently than 9% of the other 1194 servers in this category
Basic checks equal to or better than 100% of the other 1194 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Whoop MCP safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: WHOOP_CLIENT_SECRET

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 4 months ago, and the latest version (0.8.5) reached the registry 7 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: Dbx, MCP Toolbox for Databases, MCP Toolbox for Databases

Others in the same category

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Dbx

Query databases from AI agents using connections configured in DBX.

by t8y2Widely used↓ 9.4K/wk★ 30.3KUpdated 6 months ago

Runs on your computer

Install

MCP Toolbox for Databases

MCP Toolbox for Databases enables your agent to connect to your database.

by googleapisWidely used★ 16.9KUpdated yesterday

Runs on your computer

Install

MCP Toolbox for Databases

MCP Toolbox for Databases enables your agent to connect to your database.

by googleapisWidely used★ 16.9KUpdated 8 months ago

Runs on your computer

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

WHOOP MCP Server

A local Model Context Protocol (MCP) server that gives an LLM read-only access to your WHOOP fitness data. Authentication is direct OAuth against your own WHOOP developer app — there is no third-party proxy in the path. All records are mirrored into a local SQLite cache at ~/.whoop-mcp-server/whoop.db, and no data ever leaves your machine except for the authenticated calls the server itself makes to the WHOOP v2 API.

Current version: 0.8.5 — see CHANGELOG.md.

Pre-1.0 status. The API surface (tool names, response shapes, error

codes) is stabilizing but not frozen. Breaking changes may land in

0.x minor bumps during dogfooding. Patch bumps (0.8.x) are

bugfix-only. 1.0.0 will be cut when the surface has been stable for

2+ weeks of real use. Pin the minor version in CI if you're building

on top of this.

Just want to try it? Copy the prompt in

docs/AGENT_INSTALL_PROMPT.md, paste

it into Claude Code / Claude Desktop / Cursor / Windsurf, and your

agent will do the install end-to-end.

Building on this repo? Start with AGENTS.md and

docs/ARCHITECTURE.md — they're the

load-bearing conventions and one-page system map.

What this is
Install (one line via uvx)
Install with your agent
Install from source
Analysis skill: whoop-insights
Quick start
Tool catalog
MCP resources
Data model
Sync model
Event feed
Exports
What's not supported
Updating
Operations
Security and privacy
Development
For agents building on this repo
Versioning

What this is

The WHOOP MCP Server is a small Python process that speaks MCP over stdio. It exposes WHOOP v2 data (profile, body measurement, cycles, recoveries, sleeps, workouts) to any MCP-capable client — primarily Claude Desktop and Claude Code. The server is read-only. It authenticates with WHOOP using an OAuth app you register yourself, so your tokens never travel through a third-party server. The WHOOP records you fetch are written to a local SQLite cache (mode 0o600) so subsequent reads are free and offline, and the cache file never leaves your machine.

Install (one line via uvx)

# 1. Create a WHOOP developer app (one-time, free, self-serve):

https://developer-dashboard.whoop.com/apps/create

Redirect URI: http://localhost:8000/callback

Scopes: read:profile read:body_measurement read:recovery

read:cycles read:sleep read:workout offline

2. One-shot OAuth — opens browser, catches callback, saves encrypted tokens.

WHOOP_CLIENT_ID=" " \ WHOOP_CLIENT_SECRET=" " \ uvx --from whoop-mcp whoop-mcp-oauth

3. Register with Claude Code. The --env flags are required so the

server can refresh tokens when the 1-hour access token expires.

claude mcp add whoop --scope user \ --env WHOOP_CLIENT_ID="$WHOOP_CLIENT_ID" \ --env WHOOP_CLIENT_SECRET="$WHOOP_CLIENT_SECRET" \ -- uvx --from whoop-mcp whoop-mcp

No clone, no venv, no absolute paths. Don't have uv? Install it once: curl -LsSf https://astral.sh/uv/install.sh | sh (or brew install uv).

Install with your agent

Paste the prompt in docs/AGENT_INSTALL_PROMPT.md into any MCP-aware agent (Claude Code, Claude Desktop, Cursor, Windsurf, Zed, Aider). The agent will run the install for you.

Install from source (for development)

git clone https://github.com/AshwanthramKL/whoop-mcp.git

cd whoop-mcp python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt -r requirements-dev.txt .venv/bin/pytest -q # 183 tests, ~6s, all respx-mocked

Then register with -- /abs/path/to/whoop-mcp/.venv/bin/python /abs/path/to/whoop-mcp/src/whoop_mcp_server.py.

For Claude Desktop, add the equivalent entry to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), pointing command at the venv Python and args at src/whoop_mcp_server.py. Run ./scripts/fresh_install_check.sh if you want a clean-env smoke of the install path end-to-end (minus the browser OAuth flow).

Quick start

Once the server is registered, try these prompts:

Sync the cache. "Sync my WHOOP data from the last 30 days." Claude calls sync_whoop() and reports per-resource counts.
Inspect a day. "Give me yesterday's WHOOP daily summary." Claude calls get_whoop_daily_summary(date="YYYY-MM-DD") and shows a joined cycle + recovery + primary sleep + workouts record.
Export. "Export all my cached workouts to ~/whoop-workouts.csv." Claude calls export_whoop(kind="workouts", format="csv", path="...").

Analysis skill: whoop-insights

Bundled with the repo: skills/whoop-insights.

Install (one command):

whoop-mcp-install-skills            # writes to ~/.claude/skills/

That fetches the latest skill from this repo's main branch and drops it where Claude Code (and Cursor / Windsurf / Zed) auto-discovers user-scope skills. Restart your MCP client session and ask:

*"How am I doing? Run the whoop-insights skill."*

*"Generate my weekly WHOOP report."*

*"Am I overtraining? Check the last 30 days."*

The skill pulls 30 days from the cache, computes personal baselines (HRV, recovery, sleep, strain), flags anomalies with evidence, runs two correlations (sleep→next-day-recovery, strain→next-day-recovery), and optionally generates a self-contained HTML dashboard with Chart.js visualizations. Every claim cites a specific date and a specific number — the skill is instructed never to fabricate.

For repo-native developers iterating on the skill itself: whoop-mcp-install-skills --source ./skills installs from your local working tree instead of GitHub.

Tool catalog

17 tools. All list tools accept start / end as ISO-8601 and auto-paginate. Every read tool takes fresh: bool = False — pass True to bypass the cache and hit the WHOOP API, write-through to cache, and return the live response. Errors are returned as a structured {"error": {...}} envelope; tools never raise.

Tool	What it does	Key parameters
`get_whoop_auth_status`	Report OAuth token status. Call first if other tools return `AUTH_FAILED`.	—
`get_whoop_profile`	Authenticated user's WHOOP profile (name, email).	`fresh`
`get_whoop_body_measurement`	Latest body measurements: height, weight, max HR.	`fresh`
`list_whoop_cycles`	Physiological cycles in a time window.	`start`, `end`, `limit`, `fresh`
`get_whoop_cycle`	One cycle by integer ID.	`cycle_id`, `fresh`
`get_whoop_cycle_sleep`	Sleep record tied to a given cycle.	`cycle_id`, `fresh`
`get_whoop_cycle_recovery`	Recovery record tied to a given cycle.	`cycle_id`, `fresh`
`list_whoop_recoveries`	Recoveries (HRV / RHR / recovery score) in a window.	`start`, `end`, `limit`, `fresh`
`list_whoop_sleeps`	Sleep activities incl. naps in a window.	`start`, `end`, `limit`, `fresh`
`get_whoop_sleep`	One sleep activity by UUID.	`sleep_id`, `fresh`
`list_whoop_workouts`	Workouts with zone durations (seconds).	`start`, `end`, `limit`, `fresh`
`get_whoop_workout`	One workout by UUID.	`workout_id`, `fresh`
`get_whoop_daily_summary`	Joined cycle + recovery + primary sleep + workouts for a UTC date.	`date`
`sync_whoop`	Refresh cache from WHOOP API. Idempotent, incremental by default.	`full`, `since`, `resources`
`get_whoop_events`	Chronological "what's new" feed across cached resources.	`since`, `until`, `resources`, `limit`
`export_whoop`	Dump cached records to CSV / JSONL / Parquet.	`kind`, `format`, `path`, `start`, `end`, `overwrite`
`health_check`	Composite status (auth, API, cache, schema). Never raises.	`live`

Error codes: AUTH_FAILED, RATE_LIMITED, NOT_FOUND, UPSTREAM_ERROR, VALIDATION_ERROR, CACHE_ERROR, CACHE_EMPTY, FILE_EXISTS, EXPORT_ERROR, SYNC_ERROR.

MCP resources

The cache is also exposed as read-only MCP resources, so the client can browse date slices without invoking a tool.

URI	Content
`whoop://db/cycles/{start}/{end}`	Cached cycles in `[start, end)` (dates `YYYY-MM-DD`).
`whoop://db/recoveries/{start}/{end}`	Cached recoveries.
`whoop://db/sleeps/{start}/{end}`	Cached sleeps (including naps).
`whoop://db/workouts/{start}/{end}`	Cached workouts.
`whoop://db/profile`	Latest profile snapshot.
`whoop://db/body_measurement`	Latest body_measurement snapshot.
`whoop://db/sync_runs/{limit}`	Most recent sync audit rows.
`whoop://db/events/{since}`	Event feed since `since`, `until` = now.
`whoop://db/events/{since}/{until}`	Event feed for explicit window.

All resources return application/json. Bad inputs return the same {"error": {"code","message"}} envelope used by tools.

Data model

Responses are flattened: the WHOOP score wrapper is lifted, milliseconds become seconds (*_seconds, 1 decimal), kilojoules become calories (calories, rounded int), heart-rate keys are renamed to avg_hr_bpm / max_hr_bpm, and sleep stages are named deep_sleep_seconds, rem_sleep_seconds, light_sleep_seconds, awake_seconds, in_bed_seconds. Raw user_id, v1_id, and per-record created_at are dropped.

`score_state` convention. WHOOP scores are not always computed. When score_state != "SCORED" (e.g. PENDING_SCORE, UNSCORABLE) every derived score field is null and the top-level score_state is preserved so callers know why.

One flattened record per resource:

// Cycle

{ "id": 123456, "start": "2026-04-20T04:00:00.000Z", "end": "2026-04-21T04:00:00.000Z", "timezone_offset": "+00:00", "score_state": "SCORED", "strain": 12.4, "avg_hr_bpm": 62, "max_hr_bpm": 168, "calories": 2810 }

// Recovery

{ "cycle_id": 123456, "sleep_id": "bb68db7b-...", "score_state": "SCORED", "recovery_score": 74, "resting_heart_rate_bpm": 48, "hrv_rmssd_ms": 87.3, "spo2_pct": 97.4, "skin_temp_c": 33.1, "user_calibrating": false }

// Sleep

{ "id": "bb68db7b-...", "cycle_id": 123456, "start": "2026-04-20T03:10:00.000Z", "end": "2026-04-20T10:42:00.000Z", "nap": false, "score_state": "SCORED", "sleep_performance_pct": 88.0, "in_bed_seconds": 27120.0, "light_sleep_seconds": 12540.0, "rem_sleep_seconds": 5280.0, "deep_sleep_seconds": 6840.0, "awake_seconds": 1080.0 }

// Workout

{ "id": "a91f...", "start": "2026-04-20T17:00:00.000Z", "end": "2026-04-20T17:48:00.000Z", "sport_name": "Running", "score_state": "SCORED", "strain": 9.3, "avg_hr_bpm": 142, "max_hr_bpm": 176, "calories": 511, "distance_meter": 8030.0, "zone_durations

Only the beginning is shown; read the rest in the repo

Whoop MCP

What it does

Install

Install Python (uv)

Sign up and create a Whoop MCP key

Fill in 1 setting(s)

Open the Claude desktop app’s settings file

Paste these settings and save the file

Quit Claude and open it again

Try it

What you can do instead

Install Python (uv)

Sign up and create a Whoop MCP key

Fill in 1 setting(s)

Open Terminal

Paste this command and press Enter

Type /mcp in Claude Code

Try it

Install Python (uv)

Sign up and create a Whoop MCP key

Fill in 1 setting(s)

Click this button to open Cursor

Fill in your key

Open the AI chat in Cursor in Agent mode

Try it

Install Python (uv)

Sign up and create a Whoop MCP key

Fill in 1 setting(s)

Click this button to open VS Code

Fill in your key

Open the AI chat in VS Code in Agent mode

Try it

Installed on your computer

Values you fill in

At a glance

Which apps can use it

Related guides

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Discussion

User reviews

Compared with others in Databases & datasetsi

Common questions

Others in the same category

Dbx

MCP Toolbox for Databases

MCP Toolbox for Databases

README from the maker

WHOOP MCP Server

Table of contents

What this is

Install (one line via uvx)

https://developer-dashboard.whoop.com/apps/create

Redirect URI: http://localhost:8000/callback

Scopes: read:profile read:body_measurement read:recovery

read:cycles read:sleep read:workout offline

2. One-shot OAuth — opens browser, catches callback, saves encrypted tokens.

3. Register with Claude Code. The --env flags are required so the

server can refresh tokens when the 1-hour access token expires.

Install with your agent

Install from source (for development)

Quick start

Analysis skill: whoop-insights

Tool catalog

MCP resources

Data model