MCP for Hevy

Gestiona tus entrenamientos y rutinas de Hevy con este MCP.

Documentación

Tus entrenamientos de Hevy, en cualquier chat de IA.

Conecta Claude, Cursor, Codex o cualquier cliente MCP a tu cuenta de Hevy. Pregunta sobre tu progreso, registra entrenamientos, crea rutinas: sin necesidad de instalar nada.

Míralo en acción

Conversation: a chart of 6 months of weekly sets per muscle group

Conversación: un gráfico de 6 meses de series semanales por grupo muscular

Conversation: favorite training day, exercise and which muscle to train more

Conversación: día de entrenamiento favorito, ejercicio y qué músculo entrenar más

Conversation: which exercises to add or remove to improve the routine

Conversación: qué ejercicios añadir o eliminar para mejorar la rutina

Conversation: a push/pull/legs routine created and saved to Hevy

Conversación: una rutina de empuje/tirón/pierna creada y guardada en Hevy

Conversation: a GitHub-style heatmap calendar of training volume showing skipped weeks

Conversación: un calendario de mapa de calor estilo GitHub del volumen de entrenamiento que muestra semanas omitidas

Conversation: this month vs last month volume per muscle group as grouped bars

Conversación: este mes vs el mes pasado, volumen por grupo muscular como barras agrupadas

Conversation: a radar chart breaking down the last month's training balance by muscle group

Conversación: un gráfico de radar que desglosa el equilibrio de entrenamiento del último mes por grupo muscular

¿Aún no tienes Hevy?

Hevy es la aplicación gratuita detrás de todo esto: registra tus entrenamientos, supera tus récords personales y observa cómo tu progreso despega.

Únete a Hevy gratis

14M+ atletas ⭐ 4.9 App Store ⭐ 4.9 Google Play

¿Ya tienes Hevy? Conéctalo en 2 minutos.

1 Obtén tu clave de API de Hevy

Inicia sesión en hevy.com, abre Configuración → Desarrollador y genera una clave de API.

¿Aún no tienes cuenta? Regístrate en Hevy gratis primero.

Hevy settings page: Developer section with the Generate API Key button

2 Añade el servidor a tu cliente MCP

  1. Abre Claude Desktop y ve a Configuración → Desarrollador → Editar configuración. Abre el archivo claude_desktop_config.json con cualquier editor de texto.

  2. Copia esto en el archivo y reemplaza <your api key> con la clave del paso 1: Copiar

    {
      "mcpServers": {
        "hevy": {
          "command": "npx",
          "args": [
            "-y", "mcp-remote",
            "https://unofficial-hevy-mcp.up.railway.app/mcp",
            "--header", "X-HEVY-API-KEY:${HEVY_API_KEY}"
          ],
          "env": { "HEVY_API_KEY": "<your api key>" }
        }
      }
    }
    
  3. Guarda el archivo y reinicia Claude Desktop. Después de unos segundos verás las herramientas de Hevy disponibles.

  4. Abre Codex y ve a Configuración → Conectores → Conectar un MCP personalizado.

  5. Nómbralo Hevy, selecciona Streamable HTTP y pega esta URL: https://unofficial-hevy-mcp.up.railway.app/mcp Copiar

  6. En Encabezados, añade X-HEVY-API-KEY con la clave del paso 1 como su valor, como en la imagen, y pulsa Guardar: Codex custom MCP dialog with the Hevy MCP URL and X-HEVY-API-KEY header filled in

  7. Abre Cursor y ve a Configuración → MCP → Añadir nuevo servidor MCP. Se abre un archivo llamado mcp.json.

  8. Copia esto en el archivo y reemplaza <your api key> con la clave del paso 1: Copiar

    {
      "mcpServers": {
        "hevy": {
          "url": "https://unofficial-hevy-mcp.up.railway.app/mcp",
          "headers": { "X-HEVY-API-KEY": "<your api key>" }
        }
      }
    }
    
  9. Guarda el archivo: Cursor se conecta de inmediato. Asegúrate de que el interruptor hevy esté activado.

Tu clave de API nunca se almacena.

3 Pregunta lo que quieras

Luego simplemente habla con tu asistente en lenguaje natural. Algunas ideas:

Sigue tu progreso

  • "¿Cómo está progresando mi press de banca este año?"
  • "¿Cuáles son mis récords personales de sentadilla y peso muerto?"

Planifica mejor

  • "¿Estoy entrenando todos los grupos musculares de forma equilibrada?"
  • "Créame una rutina de empuje/tirón/pierna de 3 días y guárdala en Hevy."

Registra sobre la marcha

  • "Registra el entrenamiento de hoy: 5×5 sentadillas a 120 kg."
  • "Registra el peso corporal de hoy: 78 kg."

Estado

Comprobando API de Hevy…

Comprobando servidor MCP…

Preguntas frecuentes

¿Es una aplicación oficial de Hevy?

No. Este es un proyecto independiente y no oficial, y no está afiliado a Hevy. Utiliza la API pública de Hevy para conectar tu cuenta a asistentes de IA.

¿Es gratis?

Sí. El servidor es completamente gratuito y no hay nada que instalar: solo pegas una URL en tu cliente de IA y conectas tu cuenta de Hevy.

¿Con qué asistentes de IA funciona?

Con cualquier cliente compatible con MCP, incluidos Claude (Desktop y Code), Cursor y Codex. La configuración toma aproximadamente un minuto.

¿Mi clave de API de Hevy está segura?

Tu clave de API permanece en la configuración de tu cliente de IA en tu propio dispositivo. El servidor la reenvía a Hevy con cada solicitud y nunca la almacena.

¿Qué puedo pedirle que haga?

Seguir tu progreso y récords personales, comprobar si tu entrenamiento está equilibrado, crear y guardar rutinas en Hevy, y registrar entrenamientos o mediciones corporales, todo en lenguaje natural.