Cómo conectar WHOOP a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → WHOOP, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

WHOOP + Gemini

Lee la recuperación, el HRV, la frecuencia cardiaca en reposo, el sueño y las siestas con sus fases, el esfuerzo diario por ciclo, los entrenamientos con zonas de frecuencia cardiaca, el perfil y las medidas corporales de un miembro de WHOOP a través de la WHOOP Developer API v2 con OAuth. Solo lectura.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

WHOOP_CLIENT_ID, WHOOP_CLIENT_SECRET

Paso 1 — Obtener credenciales

La configuración lleva unos 10 minutos y se hace una sola vez. Necesitas una cuenta de WHOOP.

1. Abre el WHOOP Developer Dashboard en https://developer-dashboard.whoop.com e inicia sesión con una cuenta de WHOOP. Crea un equipo cuando se te pida (un equipo puede tener hasta 5 apps).
2. Haz clic en Create App. En Scopes marca read:profile, read:body_measurement, read:cycles, read:recovery, read:sleep y read:workout. El conector también pide offline, que WHOOP necesita para emitir un refresh token.
3. En Redirect URIs añade https://cloud.anythingmcp.com/api/mcp-oauth/callback en AnythingMCP Cloud, o <your AnythingMCP URL>/api/mcp-oauth/callback si alojas AnythingMCP tú mismo.
4. Guarda y copia el Client ID y el Client Secret en WHOOP_CLIENT_ID y WHOOP_CLIENT_SECRET. Instala el conector, haz clic en Authorize with Provider y permite el acceso con la cuenta de WHOOP cuyos datos debe leer la IA.
5. Ejecuta whoop_get_profile para comprobar la conexión.

Los access tokens duran aproximadamente una hora y se renuevan automáticamente; WHOOP sustituye el refresh token en cada renovación.

Qué lee: el perfil y las medidas corporales del miembro conectado (altura, peso, frecuencia cardiaca máxima); los ciclos fisiológicos, donde un ciclo es un día de WHOOP de despertar a despertar, con esfuerzo del día, energía y frecuencia cardiaca; la recuperación de cada ciclo con puntuación de recuperación, HRV, frecuencia cardiaca en reposo y, en WHOOP 4.0 o posterior, SpO2 y temperatura de la piel; los sueños y las siestas con tiempo por fase, necesidad de sueño, rendimiento, regularidad, eficiencia y frecuencia respiratoria; y los entrenamientos con deporte, esfuerzo, frecuencia cardiaca, energía, distancia, altitud y tiempo en cada zona de frecuencia cardiaca.

Encontrar un día: la IA lista los ciclos (el más reciente no tiene end mientras está en curso) y pasa del id de un ciclo a su recuperación y su sueño. Para las tendencias lista recuperaciones, sueños o entrenamientos entre un start y un end.

Solo lectura: todas las herramientas solo leen. La API de WHOOP no ofrece ninguna forma de escribir datos, así que no hay nada que confirmar y ninguna herramienta está desactivada al instalar. Las entradas del diario, el monitor de estrés, los flujos de frecuencia cardiaca y WHOOP Coach no forman parte de la API pública.

Formatos: solo los registros con score_state SCORED llevan puntuación; PENDING_SCORE significa que WHOOP todavía la está calculando, UNSCORABLE que nunca la tendrá (por ejemplo, cuando no se llevó puesta la pulsera). Las horas están en UTC, y timezone_offset es el desfase local del miembro, que la IA aplica antes de nombrar un día local. Las duraciones que terminan en _milli están en milisegundos. El esfuerzo usa la escala de WHOOP de 0 a 21, kilojoule es energía (divide entre 4,184 para obtener kilocalorías), los porcentajes van de 0 a 100 y las frecuencias cardiacas están en latidos por minuto.

Límites: las herramientas de lista devuelven hasta 25 registros por llamada, del más reciente al más antiguo, con un next_token mientras haya más. WHOOP permite por defecto 100 solicitudes por minuto y 10.000 al día por app; por encima responde 429.

Errores comunes: 401 significa que la autorización caducó o fue revocada (vuelve a hacer clic en Authorize with Provider), 403 o una respuesta vacía para un tipo de datos suele significar que no se concedió su scope, y 404 un id desconocido.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de WHOOP.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuál es mi puntuación de recuperación hoy, y cómo se comparan mi HRV y mi frecuencia cardiaca en reposo con mi media de 30 días?"
• "¿Cuánto dormí cada noche esta semana, y cuánto de ese tiempo fue sueño REM y sueño de ondas lentas?"
• "Lista mis entrenamientos de las dos últimas semanas con deporte, esfuerzo y tiempo en las zonas de frecuencia cardiaca 4 y 5."
• "¿Cómo fue mi recuperación las mañanas siguientes a un día con un esfuerzo superior a 15?"
• "¿He echado alguna siesta este mes, y cuánto duraron?"

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot