Cómo conectar WHOOP a Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de WHOOP.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

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

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

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