hevy-mcp

Un servidor de Python Model Context Protocol (MCP) para la API de la aplicación de fitness Hevy. Proporciona a Claude (o a cualquier IA compatible con MCP) acceso total a tus datos de entrenamiento de Hevy: registra entrenamientos, gestiona rutinas, realiza un seguimiento de las medidas corporales y más.

Características

• 25 herramientas que cubren todos los endpoints de la API de Hevy

• Sin pasos de compilación: Python puro, solo instala y ejecuta

• CRUD completo: crea, lee y actualiza entrenamientos, rutinas, plantillas de ejercicios, carpetas, medidas y webhooks

Herramientas

Requisitos

• Python 3.10+

• Cuenta Hevy Pro (necesaria para el acceso a la API)

• Clave de API de hevy.com/settings?developer

Instalación

git clone https://github.com/YOUR_USERNAME/hevy-mcp
cd hevy-mcp
pip install -r requirements.txt

Configuración

Claude Desktop

Añade esto a claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hevy": {
      "command": "python",
      "args": ["/absolute/path/to/hevy-mcp/server.py"],
      "env": {
        "HEVY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Reinicia Claude Desktop. Deberías ver el servidor Hevy listado bajo el icono de herramientas en el chat.

Variable de entorno

Alternativamente, establece HEVY_API_KEY en tu entorno y ejecuta directamente:

export HEVY_API_KEY=your-api-key-here
python server.py

Ejemplos de uso

Una vez conectado, puedes pedirle a Claude cosas como:

• "Muéstrame mis últimos 5 entrenamientos"

• "Registra un entrenamiento de pecho que hice hoy: press de banca 3x8 a 100kg, press inclinado con mancuernas 3x10 a 30kg"

• "Crea una rutina de Empuje/Tracción/Pierna"

• "¿Cuál es la tendencia de mi peso corporal durante el último mes?"

• "Busca el ID de la plantilla de ejercicio para peso muerto rumano"

• "Muéstrame todas mis series de press de banca de los últimos 3 meses"

Stack tecnológico

• FastMCP: framework de servidor MCP en Python

• httpx: cliente HTTP

• API de Hevy: API REST oficial

Licencia

MIT