Whoop MCP Server

Name: Whoop MCP Server
Author: rajdeepmondaldotcom

von rajdeepmondaldotcomVersion 0.0.12i★ –iLäuft auf deinem Computer

Name in der Registryio.github.rajdeepmondaldotcom/whoop-mcp-server

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

WHOOP recovery, sleep, strain, and workouts for any AI. Analysis tools, demo mode, fast setup.

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiGanz neu↓ 107/Wo. · ★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Praxen & Gesundheit

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Das trägst du selbst ein: WHOOP_MCP_DEMO

Du brauchst

PyPIuv für Python installiert (für den Befehl uvx)

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

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

Führe das in deinem Terminal aus

claude mcp add whoop --env WHOOP_MCP_DEMO=your-value -- uvx whoop-mcp-server

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

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

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

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

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

WHOOP_MCP_DEMO env
Set to 1 to serve realistic generated data (no WHOOP account needed)

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 8. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto rajdeepmondaldotcom bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Praxen & Gesundheiti

Mehr Sterne als 0 % der anderen 1027 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 15 % der anderen 1027 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 1027 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Whoop MCP Server sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.0.12) kam vor 5 Monaten in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Python (uv) auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Mirobody, FHIR MCP Server, Google Health MCP

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Mirobody

Lab results to LOINC codes and UCUM units, symptoms and diagnoses to ICPC-3. Offline, no API key.

von thetahealthWachsend↓ 290/Wo.★ 1408Aktualisiert gestern

Läuft auf deinem Computer✓ thetahealth.ai

Installieren

FHIR MCP Server

MCP server providing seamless access to FHIR APIs for AI tools and healthcare applications

von wso2Wachsend↓ 823/Wo.★ 137Aktualisiert vor 10 Tagen

Läuft auf deinem Computer

Installieren

Google Health MCP

Privacy-first unofficial Google Health API v4 MCP server for health, sleep, activity, HR agents

von davidmosiahWachsend↓ 1024/Wo.★ 79Aktualisiert vor 4 Monaten

Läuft auf deinem Computer

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

whoop-mcp-server

Your WHOOP shows you charts. It can't answer "should I train hard today" or "what actually hurts my recovery". This server can.

It connects your WHOOP data to Claude, ChatGPT, and any MCP client. You ask in plain English. It computes the answer from your own records and lets the AI explain it.

You: should I train hard today?

AI: Recovery 81% (green). HRV trending up. Sleep debt cleared. Your 7-day load is 0.94x your 28-day base. You are conditioned for more.

Runs on your machine. Read-only. The only network peer is api.prod.whoop.com. No telemetry. MIT.

What you need

A WHOOP account. Any membership works.
uv or pipx, to install one command line tool.
An MCP client: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, or ChatGPT.

One constraint to know before you start. WHOOP has no shared developer app, so during setup you create your own free one. It takes about two minutes of clicking, and it is the reason this is private by design: your tokens belong to your app, on your machine, and your health data never routes through anyone else's server. Including mine.

Set it up

Install the tool:

uv tool install whoop-mcp-server

(pipx install whoop-mcp-server works the same.)

Then run the one command that does everything:

whoop-mcp-server setup

Here is what happens, in order, so nothing surprises you:

Your WHOOP app. The wizard opens WHOOP's developer dashboard and tells you exactly what to click: create a team, create an app, enable every scope including offline, set the redirect URL to exactly http://localhost:8765/callback. The form requires a privacy policy URL. Use this repo's: https://github.com/rajdeepmondaldotcom/whoop-mcp-server/blob/main/PRIVACY.md. Copy the Client ID and Secret, paste them into the terminal. They're stored locally with 0600 permissions.

Authorize. Your browser opens WHOOP's consent screen. Approve it. Tokens land in ~/.whoop-mcp and refresh themselves from then on. You never do this again.

Proof. The wizard makes a live API call and prints your actual latest recovery. If anything is misconfigured, you find out here, in the terminal, not later in a chat window.

Your clients. It detects Claude Desktop, Cursor, Windsurf, VS Code, and Claude Code, and writes their configs for you. Existing config is backed up before any edit. If Claude Desktop is running, the wizard asks to quit it first, because Desktop silently overwrites config edits made while it's open. Then it launches the configured command once and confirms the server answers. "Done" means verified, not hopeful.

Restart your client. Ask it: "How did I sleep last night?" Then ask the better question: "Give me the full picture of my health this quarter."

Two useful asides. If you want to see the tools work before connecting anything, whoop-mcp-server serve --demo serves 150 days of realistic generated data through the same pipeline. And if anything misbehaves later, whoop-mcp-server doctor names what's wrong and the fix.

What you can ask

24 tools cover every public user-readable endpoint in WHOOP's API, plus the analysis layer that turns records into answers.

Ask	Tool behind it
"Give me the full picture of my health"	`get_health_overview`: status, trends, training load, records, and correlations in one call
"How am I doing today?"	`get_daily_summary`: recovery, sleep, strain, workouts for any day
"What actually affects my recovery?"	`get_correlations`: strain vs next-morning recovery, sleep vs recovery, with plain readings
"Am I overtraining?"	`get_strain_trends`: acute vs chronic load, per-sport breakdown
"Is my HRV improving?"	`get_recovery_trends`: direction, confidence, unusual days
"Show my overnight heart rate curve"	`get_sleep_stream`: minute-level HR and skin temp, lowest point and when; `include_raw=true` keeps WHOOP's untouched stream
"This month vs last month?"	`compare_periods`: every metric, improved or declined
"My records this year?"	`get_personal_records`: bests, worsts, green streaks
"Export everything"	`export_data`: full collection history to local JSON and CSV, with raw records by default
Week grids, raw records, profile	`get_weekly_report`, `get_sleeps/workouts/cycles/recoveries`, by-id tools with `include_raw`, `get_profile(include_raw=true)`
"I have an old WHOOP activity id"	`get_activity_mapping`: map a legacy v1 activity id to its v2 UUID
Connection trouble	`get_connection_status`, `connect_whoop_account`

Dates are plain English everywhere: yesterday, last 30 days, this week, 2 years ago, 2026-05.

ChatGPT's required search and fetch tools are implemented too, plus 4 resources and 4 ready-made prompts (morning_readiness, weekly_review, sleep_coach, training_planner).

More questions worth asking: docs/PROMPTS.md.

Works with

Client	Setup
Claude Desktop	`whoop-mcp-server setup` configures it for you. No terminal at all: download `whoop-mcp-server.mcpb` from the latest release and open it (needs uv installed; demo mode is a toggle in its settings)
Claude Code	`claude mcp add whoop -- whoop-mcp-server serve` (setup offers this too)
Cursor	auto via setup, or
Windsurf	auto via setup
VS Code	auto via setup, or
ChatGPT	remote connector, see below
Docker	`docker build -t whoop-mcp-server . && docker run -i --rm -e WHOOP_MCP_DEMO=1 whoop-mcp-server` (mount `~/.whoop-mcp` for real data)
Any MCP client	`command: whoop-mcp-server` with `args: ["serve"]`. Inspector: `npx @modelcontextprotocol/inspector whoop-mcp-server serve`

ChatGPT setup

ChatGPT connects to remote MCP servers, so expose the HTTP transport and tunnel it:

whoop-mcp-server serve --transport http --port 8000    # endpoint: /mcp

ngrok http 8000

Then in ChatGPT: Settings, Apps & Connectors, Advanced settings, enable Developer mode, create a connector with https:// /mcp and no auth.

Be careful here: a no-auth tunnel means anyone with the URL can read your health data. Keep the URL private and the tunnel short-lived. Claude's stdio setup never exposes anything.

Why the answers hold up

The model is maybe 20% of this product. The other 80% is making the numbers right. Models are bad at arithmetic over 90 days of records, so this server computes first and lets the model explain.

Trend lines are fit to date-sorted series. WHOOP returns records newest-first. Fit arrival order instead and every trend reads backwards.
Direction respects what the metric means. Rising HRV is improvement. Rising resting heart rate is not.
Records land on calendar days using their own timezone offset. A sleep belongs to the morning you woke up, even when you travel.
WHOOP rotates both OAuth tokens on every refresh. Refreshes here are serialized, saved before use, and shared across concurrent requests. Re-running auth rescues a live server without a restart.
The client honors WHOOP's rate-limit headers, retries with backoff, and caps pagination. When a result is truncated or approximate, the output says so instead of pretending it's complete.

What it can't do: WHOOP's public API has no endpoints yet for Peak features like the stress monitor and healthspan. When WHOOP ships them, they land here. The overnight sensor stream isn't enabled for every account, and the tool reports that instead of failing. Bulk export intentionally fetches the collection endpoints; raw sleep streams are available per sleep with get_sleep_stream(include_raw=true).

105 tests, all offline against a faked WHOOP API. CI on Python 3.10 to 3.13.

CLI

whoop-mcp-server setup     Guided setup: app, authorize, auto-configure clients

whoop-mcp-server serve Run the server (--demo, --transport stdio|http|sse, --host, --port) whoop-mcp-server status Config and token state whoop-mcp-server doctor Diagnose setup and connectivity whoop-mcp-server auth Scriptable OAuth flow whoop-mcp-server logout Delete tokens (--revoke also revokes at WHOOP)

Configuration

Nothing required after whoop-mcp-server setup. Overrides, in priority order: process env, ./.env, ~/.whoop-mcp/.env, ~/.whoop-mcp/config.json.

Variable	Default	Purpose
`WHOOP_CLIENT_ID` / `WHOOP_CLIENT_SECRET`	none	WHOOP app credentials
`WHOOP_REDIRECT_URI`	`http://localhost:8765/callback`	Must exactly match the dashboard
`WHOOP_MCP_DEMO`	off	`1` serves demo data (same as `--demo`)
`WHOOP_MCP_DIR`	`~/.whoop-mcp`	Tokens, config, exports
`WHOOP_MCP_TZ`	system zone	IANA timezone for "today" and week bounds
`WHOOP_MCP_CACHE_TTL` / `WHOOP_MCP_TIMEOUT`	`60` / `30`	Seconds
`WHOOP_MCP_LOG_LEVEL`	`INFO`	Logs go to stderr. stdout belongs to MCP
`WHOOP_ACCESS_TOKEN`	none	Static token for testing, no refresh

Privacy

Read-only against WHOOP. Tokens stored locally with 0600 permissions. The only writes are local files you ask for (export_data) and the OAuth flow you trigger. One thing worth knowing: aggregates like trends and correlations can reveal more about you than single records. Connect this only to AI clients you trust with health data. Full policy: PRIVACY.md. Vulnerabilities: SECURITY.md.

Contributing

uv venv && uv pip install -e ".[dev]" && pytest && ruff check .

The whole test suite runs offline. CONTRIBUTING.md lists the invariants that keep the data honest. The short version of the architecture: client.py talks to WHOOP, transform.py cleans the records, summaries.py and analytics.py do the math, server.py exposes the tools. oauth.py and tokens.py own auth. demo.py is the generated account.

Troubleshooting

Symptom	Fix
"WHOOP authorization required"	`whoop-mcp-server setup`, or ask your AI to connect your WHOOP account
Redirect fails after consent	The dashboard redirect URI must be exactly `http://localhost:8765/callback`
`403 missing scope`	Enable all read scopes plus `offline` on the app, then re-run `whoop-mcp-server auth`
Tools missing in a client	Re-run `whoop-mcp-server setup`, then fully restart the client
No recovery shown today	WHOOP scores it after you wake and sync. The summary says so
Sleep stream "not available"	WHOOP doesn't expose it for every account. Nightly summaries still work

| Anything else | whoop-mcp-server doctor, or get_connection_status from

Nur der Anfang wird gezeigt; den Rest findest du im Repo

Whoop MCP Server

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Praxen & Gesundheiti

Häufige Fragen

Alternativen

Mirobody

FHIR MCP Server

Google Health MCP

README vom Entwickler

whoop-mcp-server

What you need

Set it up

What you can ask

Works with

Why the answers hold up

CLI

Configuration

Privacy

Contributing

Troubleshooting