WhoopMCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@WhoopMCP show my recovery score for today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
WHOOP MCP
Servidor MCP (Model Context Protocol) para la API de WHOOP v2. Permite que Claude (Desktop, Code, etc.) consulte tus datos de WHOOP: recovery, sueño, ciclos fisiológicos, entrenamientos, perfil y medidas corporales.
Herramientas disponibles
Herramienta | Descripción |
| Perfil básico (nombre, email, user_id) |
| Altura, peso y FC máxima |
| Ciclos fisiológicos (strain, calorías, FC) con filtro por fechas |
| Un ciclo concreto por ID |
| Recoveries (score, HRV, FC en reposo, SpO2, temperatura) |
| Recovery asociada a un ciclo |
| Sesiones de sueño (etapas, eficiencia, rendimiento) |
| Una sesión de sueño concreta por UUID |
| Sueño asociado a un ciclo |
| Entrenamientos (deporte, strain, zonas de FC, distancia) |
| Un entrenamiento concreto por UUID |
Las herramientas de colección aceptan start, end (ISO 8601), limit (máx. 25) y nextToken para paginar.
Related MCP server: whoop-mcp-server
Instalación
npm install
npm run buildAutenticación
Necesitas una app de desarrollador de WHOOP:
Entra en el WHOOP Developer Dashboard y crea una app.
Añade
http://localhost:8917/callbackcomo Redirect URI.Apunta el
Client IDy elClient Secret.
Opción A (recomendada): refresh token con renovación automática
export WHOOP_CLIENT_ID="tu_client_id"
export WHOOP_CLIENT_SECRET="tu_client_secret"
npm run authEl script abre la URL de autorización de WHOOP, captura el redirect en local e imprime el WHOOP_REFRESH_TOKEN. Con las tres variables definidas, el servidor renueva el access token automáticamente (WHOOP rota el refresh token en cada renovación; el servidor lo gestiona en memoria durante la sesión).
Opción B: access token estático
export WHOOP_ACCESS_TOKEN="tu_access_token"Caduca en ~1 hora; útil solo para pruebas.
Configuración en Claude
Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"whoop": {
"command": "node",
"args": ["/ruta/a/WhoopMCP/dist/index.js"],
"env": {
"WHOOP_CLIENT_ID": "tu_client_id",
"WHOOP_CLIENT_SECRET": "tu_client_secret",
"WHOOP_REFRESH_TOKEN": "tu_refresh_token"
}
}
}
}Claude Code
claude mcp add whoop \
-e WHOOP_CLIENT_ID=tu_client_id \
-e WHOOP_CLIENT_SECRET=tu_client_secret \
-e WHOOP_REFRESH_TOKEN=tu_refresh_token \
-- node /ruta/a/WhoopMCP/dist/index.jsEjemplos de uso
Una vez conectado, puedes pedirle a Claude cosas como:
«¿Cómo fue mi recovery esta semana?»
«Compara mi sueño de los últimos 7 días»
«¿Cuál fue mi entrenamiento con más strain este mes?»
Desarrollo
npm run dev # ejecuta el servidor con tsx (sin compilar)
npm run typecheck # comprobación de tiposNotas
Usa la API v2 de WHOOP (
https://api.prod.whoop.com/developer/v2); la v1 está obsoleta desde octubre de 2025.Todas las herramientas son de solo lectura.
Los errores de la API (401, 404, rate limit…) se devuelven como resultados de error legibles, no como fallos del servidor.
Available Tools
11 toolsget_body_measurementsMedidas corporalesA
Obtiene las medidas corporales del usuario: altura (m), peso (kg) y frecuencia cardíaca máxima.
Inputs: no named parameters.
get_cycle_by_idCiclo por IDA
Obtiene un ciclo fisiológico concreto por su ID.
Inputs: cycleId (required).
get_cyclesCiclos fisiológicosA
Lista los ciclos fisiológicos del usuario (días WHOOP), con strain, calorías y frecuencia cardíaca media/máxima. Ordenados del más reciente al más antiguo. Usa start/end para filtrar por fechas y nextToken para paginar.
Inputs: end, limit, start, nextToken.
get_recoveriesRecoveriesA
Lista las puntuaciones de recovery del usuario (recovery score, HRV, frecuencia cardíaca en reposo, SpO2, temperatura de la piel). Ordenadas de la más reciente a la más antigua. Usa start/end para filtrar por fechas.
Inputs: end, limit, start, nextToken.
get_recovery_for_cycleRecovery de un cicloA
Obtiene la recovery asociada a un ciclo fisiológico concreto.
Inputs: cycleId (required).
get_sleep_by_idSueño por IDB
Obtiene una sesión de sueño concreta por su ID (UUID).
Inputs: sleepId (required).
get_sleep_for_cycleSueño de un cicloC
Obtiene la sesión de sueño asociada a un ciclo fisiológico concreto.
Inputs: cycleId (required).
get_sleepsSesiones de sueñoB
Lista las sesiones de sueño del usuario, con etapas del sueño (ligero, profundo, REM), eficiencia, necesidad de sueño y rendimiento. Ordenadas de la más reciente a la más antigua.
Inputs: end, limit, start, nextToken.
get_user_profilePerfil del usuarioA
Obtiene el perfil básico del usuario de WHOOP: user_id, email, nombre y apellido.
Inputs: no named parameters.
get_workout_by_idEntrenamiento por IDB
Obtiene un entrenamiento concreto por su ID (UUID).
Inputs: workoutId (required).
get_workoutsEntrenamientosA
Lista los entrenamientos del usuario, con deporte, strain, calorías, frecuencia cardíaca media/máxima, distancia y zonas de frecuencia cardíaca. Ordenados del más reciente al más antiguo.
Inputs: end, limit, start, nextToken.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool retrieves a distinct type of WHOOP data (cycles, recoveries, sleep, workouts, body measurements, user profile) with clear singular/plural distinctions and no overlap in functionality.
All tools follow a consistent 'get_[entity]' or 'get_[entity]_by_id' pattern with snake_case, making it predictable and easy to understand.
11 tools cover the core WHOOP data types without being excessive or insufficient, perfectly scoped for a fitness-tracking data retrieval server.
The tool set provides comprehensive read access to all major WHOOP entities (cycles, recoveries, sleep, workouts, body measurements, user profile) with list and individual retrieval methods, leaving no obvious gaps for querying.
Maintenance
Related MCP Connectors
Read WHOOP recovery, sleep, cycles, workouts and body measurements.
Your WHOOP data in the assistant, read-only: recovery, sleep, strain, workouts, cycles and body meas
Read sleep, readiness, activity, stress, heart rate and workouts from the Oura Ring.
Unofficial Garmin Connect access: sleep, HRV, training, activities, workouts and weight.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables access to WHOOP fitness and health data through all WHOOP v2 API endpoints. Supports OAuth 2.0 authentication and provides comprehensive access to user profiles, physiological cycles, recovery metrics, sleep analysis, and workout data.1616MIT
- FlicenseNot gradedqualityDmaintenanceEnables language models to query cycles, recovery, strain, and workout data from the Whoop API.-
- AlicenseBqualityDmaintenanceIntegrates with Whoop API v2 to access user profile, sleep, recovery, cycles, and workout data via natural language, with OAuth2 authentication and automatic token refresh.1420 npmMIT
- AlicenseAqualityCmaintenanceEnables Claude to query personal WHOOP health data including recovery, sleep, strain, workouts, and profile via WHOOP's OAuth 2.0 REST API.614 npmMIT