Whoop MCP

Name: Whoop MCP
Author: AshwanthramKL

de AshwanthramKLversión 0.8.5i★ –iSe ejecuta en tu computadora

Nombre en el registroio.github.AshwanthramKL/whoop-mcp

Instalar

Resumen

Descripción del creador (original en inglés)

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

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiMuy nuevo↓ 74/sem · ★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio
Categoría: Bases de datos y conjuntos de datos
Debes completar: WHOOP_CLIENT_ID, WHOOP_CLIENT_SECRET

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 1 de 1 superadas
Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
Debes completar tú: WHOOP_CLIENT_ID, WHOOP_CLIENT_SECRET, WHOOP_REDIRECT_URI, WHOOP_LOG_LEVEL, WHOOP_LOG_FILE, WHOOP_LOG_JSON

Los valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.

Necesitas

PyPIuv de Python instalado (para el comando uvx)

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

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

Ejecuta esto en tu terminal

claude mcp add whoop --env WHOOP_CLIENT_ID=your-value --env WHOOP_CLIENT_SECRET=your-value --env WHOOP_REDIRECT_URI=your-value --env WHOOP_LOG_LEVEL=your-value --env WHOOP_LOG_FILE=your-value --env WHOOP_LOG_JSON=your-value -- uvx whoop-mcp

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

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

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

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

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

WHOOP_CLIENT_ID obligatorio env
Client ID from your WHOOP developer app (https://developer-dashboard.whoop.com/apps/create).
WHOOP_CLIENT_SECRET secreto obligatorio 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.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 9 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub AshwanthramKL, dueña del repo
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Bases de datos y conjuntos de datosi

Más estrellas que el 0% de los otros 1151 servidores de esta categoría
Publicado en el registro más recientemente que el 10% de los otros 1151 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 1151 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Whoop MCP?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: WHOOP_CLIENT_ID, WHOOP_CLIENT_SECRET

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (0.8.5) llegó al registro hace 7 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Supabase, MongoDB MCP Server, Elasticsearch MCP Server

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Supabase

MCP server for interacting with the Supabase platform

de supabaseMuy usado↓ 235,4 mil/sem★ 3 milActualizado anteayer

Computadora o nube✓ supabase.com

Instalar

MongoDB MCP Server

MongoDB Model Context Protocol Server

de mongodb-jsMuy usado↓ 157,1 mil/sem★ 1,2 milActualizado hace 4 días

Se ejecuta en tu computadora

Instalar

Elasticsearch MCP Server

MCP server for interacting with Elasticsearch

de cr7258En crecimiento↓ 2,7 mil/sem★ 315Actualizado hace 14 meses

Se ejecuta en tu computadora

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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

Solo se muestra el principio; lee el resto en el repo

Whoop MCP

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Valores que debes completar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Bases de datos y conjuntos de datosi

Preguntas frecuentes

Alternativas

Supabase

MongoDB MCP Server

Elasticsearch MCP Server

README del creador

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