Skip to main content
Glama

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

get_user_profile

Perfil básico (nombre, email, user_id)

get_body_measurements

Altura, peso y FC máxima

get_cycles

Ciclos fisiológicos (strain, calorías, FC) con filtro por fechas

get_cycle_by_id

Un ciclo concreto por ID

get_recoveries

Recoveries (score, HRV, FC en reposo, SpO2, temperatura)

get_recovery_for_cycle

Recovery asociada a un ciclo

get_sleeps

Sesiones de sueño (etapas, eficiencia, rendimiento)

get_sleep_by_id

Una sesión de sueño concreta por UUID

get_sleep_for_cycle

Sueño asociado a un ciclo

get_workouts

Entrenamientos (deporte, strain, zonas de FC, distancia)

get_workout_by_id

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 build

Autenticación

Necesitas una app de desarrollador de WHOOP:

  1. Entra en el WHOOP Developer Dashboard y crea una app.

  2. Añade http://localhost:8917/callback como Redirect URI.

  3. Apunta el Client ID y el Client 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 auth

El 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.js

Ejemplos 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 tipos

Notas

  • 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 tools
get_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

    A3.8/5.0

    Scored across 11 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    All tools follow a consistent 'get_[entity]' or 'get_[entity]_by_id' pattern with snake_case, making it predictable and easy to understand.

    Tool Count5/5

    11 tools cover the core WHOOP data types without being excessive or insufficient, perfectly scoped for a fitness-tracking data retrieval server.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers