Servidor Whoop MCP

Licencia del paquete Python: MIT Python 3.12

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a la API de Whoop. Permite que los modelos de lenguaje consulten datos de ciclos, recuperación, esfuerzo y entrenamiento desde la API de Whoop.

Herramientas disponibles

El servidor expone las siguientes herramientas:

Consultas de ciclo

get_cycle_collection(start_date: str, end_date: str) : Obtener datos del ciclo para un rango de fechas específico
get_latest_cycle() : Obtener los datos del ciclo más recientes

Recuperación y tensión

get_recovery_data(start_date: str, end_date: str) : Obtener datos de recuperación para un rango de fechas específico
get_strain_data(start_date: str, end_date: str) : obtiene datos de tensión para un rango de fechas específico
get_average_strain(days: int = 7) : Calcula la deformación promedio durante un número específico de días

Perfil y autenticación

get_profile() : Obtener información del perfil del usuario
check_auth_status() : Verificar el estado de autenticación con la API de Whoop

Las fechas deben proporcionarse en formato ISO (AAAA-MM-DD).

Related MCP server: Strava MCP Server

Uso

Necesitará las credenciales de Whoop para usar este servidor. El servidor utiliza autenticación por correo electrónico y contraseña con la API de Whoop.

Claude para escritorio

Actualice su claude_desktop_config.json (ubicado en ~/Library/Application\ Support/Claude/claude_desktop_config.json en macOS y %APPDATA%/Claude/claude_desktop_config.json en Windows) para incluir lo siguiente:

{ "mcpServers": { "Whoop": { "command": "python", "args": ["/path/to/whoop/src/whoop_server.py"], "cwd": "/path/to/whoop", "env": { "WHOOP_EMAIL": "your.email@example.com", "WHOOP_PASSWORD": "your_password" } } } }

Servidor API HTTP

El proyecto también incluye un servidor de API HTTP que expone la misma funcionalidad a través de puntos finales HTTP. Para ejecutarlo:

./run_whoop_server.sh

Consultas de ejemplo

Una vez conectado, puedes hacerle preguntas a Claude como:

"¿Cuál es mi puntuación de recuperación para hoy?"
"Muéstrame mis datos de tensión de la última semana"
"¿Cuál es mi tensión promedio durante los últimos 7 días?"
"Obtener los datos de mi último ciclo"

Manejo de errores

El servidor proporciona mensajes de error legibles por humanos para problemas comunes:

Formatos de fecha no válidos
Errores de autenticación de API
Problemas de conectividad de red
Credenciales faltantes o no válidas

Estructura del proyecto

whoop/ ├── src/ │ ├── whoop_server.py # MCP server implementation │ └── whoop_http_server.py # HTTP API server implementation ├── config/ │ └── .env # Environment variables ├── requirements.txt # Python dependencies └── run_whoop_server.sh # Script to run HTTP server