hevy-mcp

hevy-mcp: puente MCP que permite el acceso conversacional a los datos de entrenamiento de Hevy

hevy-mcp, construido por Swrm Io, es un servidor MCP que conecta los datos de entrenamiento de Hevy a asistentes de IA, lo que permite consultas conversacionales y acciones rutinarias automatizadas. La herramienta expone registros de entrenamiento, gestión de rutinas, un índice de plantillas de ejercicios y medidas corporales a través de la API de Hevy para que los modelos puedan analizar el volumen de entrenamiento y sugerir ediciones de planes. Asegura las claves de API con variables de entorno y se ejecuta sobre MCP stdio. Los usuarios objetivo son los clientes de Hevy y los desarrolladores que construyen entrenadores personales impulsados por IA que desean acceso programático y consultable a los datos de entrenamiento.

Habilita el acceso directo y basado en chat a los datos de Hevy de un usuario y ediciones

La herramienta convierte la API de Hevy en una fuente de datos respaldada por MCP, para que los asistentes de IA puedan obtener y actuar sobre la información de entrenamiento. Los puntos finales compatibles incluyen el historial de entrenamientos paginado y los conteos totales, la lista de rutinas y actualizaciones, plantillas de ejercicios y entradas de medidas corporales. Los resultados típicos son consultas conversacionales sobre sesiones pasadas y ediciones de rutinas guardadas, con acciones emitidas por un asistente que llama a los puntos finales de Hevy en nombre del usuario.

La utilidad del análisis refleja la calidad de los datos de Hevy y las salidas del asistente elegido

El análisis generado depende de dos fuentes de datos: los registros de Hevy grabados por el usuario y el asistente que produce la interpretación. Los comentarios de la comunidad destacan específicamente las comprobaciones de desequilibrio de grupos musculares y el análisis de volumen como salidas prácticas. Esos resultados proporcionan señales utilizables para decisiones de entrenamiento, pero cualquier recomendación de coaching prescriptiva debe ser verificada contra las entradas de entrenamiento en bruto o un entrenador calificado, porque la herramienta proporciona datos en lugar de validación independiente.

Requiere un entorno específico y requisitos de cuenta para operar

El despliegue exige Node.js y herramientas MCP: se requiere Node.js v18 o superior, y debe estar presente un cliente compatible con MCP como Claude Desktop para usar el transporte stdio. Se necesita una clave API de Hevy válida y una cuenta Hevy Pro para acceder a la API. Las opciones de instalación incluyen la invocación de npx o clonar y construir el repositorio con Node, lo que lo alinea con flujos de trabajo de configuración orientados a desarrolladores.

Se adapta a flujos de trabajo de desarrolladores, pero el enrutamiento de datos depende de las elecciones del cliente y del asistente

El servidor está orientado a desarrolladores que construyen integraciones de agentes, y el proyecto es construido por la comunidad en lugar de ser un producto oficial de Hevy. Está diseñado para ejecutarse en cualquier sistema que soporte el Protocolo de Contexto de Modelo a través de stdio, por lo que cómo y dónde los datos salen de un host depende de la configuración del cliente MCP y del asistente. El servidor utiliza variables de entorno para las claves API, lo que ayuda a mantener las credenciales fuera del código fuente durante el trabajo de integración.

Una integración práctica para desarrolladores y usuarios de Hevy que aceptan el análisis guiado por modelos

La herramienta es una opción práctica para desarrolladores y clientes de Hevy que necesitan acceso conversacional a los registros de entrenamiento y ediciones de rutina en la aplicación; su valor depende de la calidad de los entrenamientos grabados y del asistente que produzca interpretaciones. Se espera que utilices la herramienta como un conducto de datos y combines las recomendaciones generadas con una revisión manual o supervisión experta al aplicar cambios de entrenamiento a un programa.