MCP for Hevy

Gerencie seus treinos e rotinas do Hevy com este MCP.

Documentação

Seus treinos Hevy, em qualquer chat de IA.

Conecte Claude, Cursor, Codex ou qualquer cliente MCP à sua conta Hevy. Pergunte sobre seu progresso, registre treinos, monte rotinas — sem necessidade de instalação.

Veja em ação

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

Conversa: um gráfico de 6 meses de séries semanais por grupo muscular

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

Conversa: dia de treino favorito, exercício e qual músculo treinar mais

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

Conversa: quais exercícios adicionar ou remover para melhorar a rotina

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

Conversa: uma rotina de empurrar/puxar/pernas criada e salva no Hevy

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

Conversa: um calendário de calorias estilo GitHub do volume de treino mostrando semanas puladas

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

Conversa: este mês vs mês passado volume por grupo muscular como barras agrupadas

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

Conversa: um gráfico de radar detalhando o equilíbrio de treino do último mês por grupo muscular

Ainda não tem Hevy?

Hevy é o aplicativo gratuito por trás de tudo isso — registre seus treinos, bata seus recordes pessoais, veja seu progresso decolar.

Junte-se ao Hevy gratuitamente

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

Já tem Hevy? Conecte em 2 minutos.

1 Obtenha sua chave de API Hevy

Faça login em hevy.com, abra Configurações → Desenvolvedor e gere uma chave de API.

Ainda não tem conta? Cadastre-se no Hevy gratuitamente primeiro.

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

2 Adicione o servidor ao seu cliente MCP

  1. Abra Claude Desktop e vá para Configurações → Desenvolvedor → Editar Config. Abra o arquivo claude_desktop_config.json com qualquer editor de texto.

  2. Copie isto para o arquivo e substitua <your api key> pela chave do passo 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. Salve o arquivo e reinicie o Claude Desktop. Após alguns segundos, você verá as ferramentas Hevy disponíveis.

  4. Abra Codex e vá para Configurações → Conectores → Conectar um MCP personalizado.

  5. Nomeie como Hevy, selecione Streamable HTTP e cole esta URL: https://unofficial-hevy-mcp.up.railway.app/mcp Copiar

  6. Em Cabeçalhos, adicione X-HEVY-API-KEY com a chave do passo 1 como valor — como na imagem — e clique em Salvar: Codex custom MCP dialog with the Hevy MCP URL and X-HEVY-API-KEY header filled in

  7. Abra Cursor e vá para Configurações → MCP → Adicionar novo servidor MCP. Um arquivo chamado mcp.json será aberto.

  8. Copie isto para o arquivo e substitua <your api key> pela chave do passo 1: Copiar

    {
      "mcpServers": {
        "hevy": {
          "url": "https://unofficial-hevy-mcp.up.railway.app/mcp",
          "headers": { "X-HEVY-API-KEY": "<your api key>" }
        }
      }
    }
    
  9. Salve o arquivo — o Cursor conecta imediatamente. Certifique-se de que o alternador hevy esteja ativado.

Sua chave de API nunca é armazenada.

3 Pergunte à vontade

Depois, basta conversar com seu assistente em linguagem natural. Algumas ideias:

Acompanhe seu progresso

  • "Como está meu progresso no supino este ano?"
  • "Quais são meus recordes pessoais no agachamento e no levantamento terra?"

Planeje melhor

  • "Estou treinando todos os grupos musculares de forma equilibrada?"
  • "Monte uma rotina de 3 dias de empurrar/puxar/pernas e salve no Hevy."

Registre rapidamente

  • "Registre o treino de hoje: 5×5 agachamentos a 120 kg."
  • "Registre o peso corporal de hoje: 78 kg."

Status

Verificando API Hevy…

Verificando servidor MCP…

Perguntas frequentes

Este é um aplicativo oficial do Hevy?

Não. Este é um projeto independente e não oficial, não afiliado ao Hevy. Ele usa a API pública do Hevy para conectar sua conta a assistentes de IA.

É gratuito?

Sim. O servidor é totalmente gratuito e não há nada para instalar — você apenas cola uma URL no seu cliente de IA e conecta sua conta Hevy.

Com quais assistentes de IA funciona?

Qualquer cliente compatível com MCP, incluindo Claude (Desktop e Code), Cursor e Codex. A configuração leva cerca de um minuto.

Minha chave de API Hevy está segura?

Sua chave de API permanece na configuração do seu cliente de IA no seu próprio dispositivo. O servidor a encaminha ao Hevy a cada solicitação e nunca a armazena.

O que posso pedir para ele fazer?

Acompanhar seu progresso e recordes pessoais, verificar se seu treino está equilibrado, montar e salvar rotinas no Hevy, e registrar treinos ou medidas corporais — tudo em linguagem natural.