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

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.