Hevy MCP mínimo

Un pequeño servidor local de Model Context Protocol que permite a un agente leer datos de entrenamientos de Hevy y crear rutinas de entrenamiento a través de la API pública de Hevy.

Herramientas incluidas

• hevy_list_workouts

• hevy_get_workout

• hevy_list_routines

• hevy_get_routine

• hevy_search_exercises

• hevy_get_exercise_history

• hevy_create_workout

• hevy_create_routine

Las seis primeras herramientas son de solo lectura. hevy_create_workout y hevy_create_routine escriben en la cuenta de Hevy conectada y están marcadas como mutaciones no idempotentes.

hevy_create_routine crea un plan reutilizable para una sesión futura. hevy_create_workout registra una sesión ya completada con los tiempos reales de inicio/fin y los resultados de las series. Establece por defecto los entrenamientos completados como privados y rechaza las series sin una métrica de rendimiento registrada.

Related MCP server: hevy-mcp-server

Requisitos

• Node.js 20 o superior

• Una cuenta de Hevy Pro y una clave de API de https://hevy.com/settings?developer

Instalación y validación

npm install
npm run check
npm run build
npm run smoke

Ejecución local

export HEVY_API_KEY="your-key"
npm start

El servidor se comunica a través de stdin/stdout, por lo que parecerá que espera en silencio cuando se ejecuta directamente. Un host de MCP debe iniciarlo y comunicarse con él.

Añadirlo a Codex

Compila primero el servidor, deja HEVY_API_KEY disponible en el entorno que inicia Codex y ejecuta a continuación:

codex mcp add hevy -- node /absolute/path/to/hevy-mcp/dist/index.js

Reinicia Codex después de añadir el servidor. Verifica la configuración con:

codex mcp list

No hagas commit de la clave de API ni la pases como argumento de la herramienta. El MCP solo la lee de HEVY_API_KEY y la envía a Hevy en la cabecera api-key requerida.

Primera solicitud sugerida

Lee mis cinco entrenamientos más recientes y resume la frecuencia, la selección de ejercicios y los patrones de progresión evidentes. No crees ni actualices nada.

Cuando pidas al agente que cree una rutina, exígele que muestre la rutina completa y que obtenga tu aprobación antes de llamar a hevy_create_routine.

Cuando registres un entrenamiento completado, dale al agente los ejercicios reales, los resultados de las series y los tiempos. Exígele que muestre el entrenamiento completo y que obtenga tu aprobación antes de llamar a hevy_create_workout. El agente nunca debe inventar datos.