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