MCP for Hevy Server

Manage your Hevy workouts and routines with this MCP

View on railway.app

Documentation

Your Hevy workouts,

in any AI chat.

Connect Claude, Cursor, Codex or any MCP client to your Hevy account. Ask about your progress, log workouts, build routines — no install required.

1 Get your Hevy API key

Log in at hevy.com, openSettings → Developer and generate an API key.

No account yet? Sign up for Hevy free first.

2 Add the server to your MCP client

Claude Codex Cursor

  1. Open Claude Desktop and go toSettings → Developer → Edit Config. Open the fileclaude_desktop_config.json with any text editor.
  2. Copy this into the file and replace with the key from step 1:
    Copy
{  
  "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>" }  
    }  
  }  
}

  1. Save the file and restart Claude Desktop. After a few seconds you'll see the Hevy tools available.

  2. Open Codex and go toSettings → Connectors → Connect a custom MCP.

  3. Name it Hevy, select Streamable HTTP and paste this URL:
    https://unofficial-hevy-mcp.up.railway.app/mcp Copy

  4. Under Headers, add X-HEVY-API-KEY with the key from step 1 as its value — like in the picture — and hit Save:

  5. Open Cursor and go toSettings → MCP → Add new MCP server. A file calledmcp.json opens.

  6. Copy this into the file and replace with the key from step 1:
    Copy

{  
  "mcpServers": {  
    "hevy": {  
      "url": "https://unofficial-hevy-mcp.up.railway.app/mcp",  
      "headers": { "X-HEVY-API-KEY": "<your api key>" }  
    }  
  }  
}
  1. Save the file — Cursor connects right away. Make sure thehevy toggle is on.

Your API key is never stored.

3 Ask away

Then just talk to your assistant in plain language. A few ideas:

Track your progress

  • "How is my bench press progressing this year?"
  • "What are my squat and deadlift PRs?"

Plan smarter

  • "Am I training all muscle groups in balance?"
  • "Build me a 3-day push/pull/legs routine and save it to Hevy."

Log on the fly

  • "Log today's workout: 5×5 squats at 120 kg."
  • "Record today's body weight: 78 kg."

See it in action

‹ ›

Don't have Hevy yet?

Hevy is the free app behind all of this — log your workouts, crush your PRs, watch your progress take off.

Join Hevy for free

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

Status

Hevy API checking…

MCP server checking…

Frequently asked questions

Is this an official Hevy app?

No. This is an independent, unofficial project and is not affiliated with Hevy. It uses Hevy's public API to connect your account to AI assistants.

Is it free?

Yes. The server is completely free and there's nothing to install — you just paste a URL into your AI client and connect your Hevy account.

Which AI assistants does it work with?

Any MCP-compatible client, including Claude (Desktop and Code), Cursor and Codex. Setup takes about a minute.

Is my Hevy API key safe?

Your API key stays in your AI client's config on your own device. The server forwards it to Hevy with each request and never stores it.

What can I ask it to do?

Track your progress and personal records, check whether your training is balanced, build and save routines to Hevy, and log workouts or body measurements — all in plain language.