Whoop MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Utilizes environment variables for storing Whoop credentials, with support for .env configuration files.

  • Supports deployment on macOS through Claude for Desktop configuration, with specific paths for the macOS environment.

  • Built as a Python package (3.12) that implements the MCP server functionality to connect with the Whoop API.

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).

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

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

-
security - not tested
F
license - not found
-
quality - not tested

Un servidor de protocolo de contexto de modelo que proporciona modelos de lenguaje con acceso a datos personales de fitness de Whoop, lo que permite realizar consultas sobre información de ciclos, recuperación, esfuerzo y entrenamiento desde la API de Whoop.

  1. Available Tools
    1. Cycle Queries
    2. Recovery and Strain
    3. Profile and Authentication
  2. Usage
    1. Claude for Desktop
    2. HTTP API Server
  3. Example Queries
    1. Error Handling
      1. Project Structure
        1. License
          ID: mlb49q0786