Hevy MCP unofficial

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.

2 Add the server to your MCP client

  1. Open Claude Desktop and go to Settings → Developer → Edit Config. Open the file claude_desktop_config.json with any text editor.
  2. Copy this into the file and replace <your api key> with the key from step 1: 
    {
  "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. Save the file and restart Claude Desktop. After a few seconds you'll see the Hevy tools available.
  1. Open Codex and go to Settings → Connectors → Connect a custom MCP.
  2. Name it Hevy, select Streamable HTTP and paste this URL:
    https://unofficial-hevy-mcp.up.railway.app/mcp
  3. Under Headers, add X-HEVY-API-KEY with the key from step 1 as its value — like in the picture — and hit Save: Codex custom MCP dialog with the Hevy MCP URL and X-HEVY-API-KEY header filled in
  1. Open Cursor and go to Settings → MCP → Add new MCP server. A file called mcp.json opens.
  2. Copy this into the file and replace <your api key> with the key from step 1: 
    {
  "mcpServers": {
    "hevy": {
      "url": "https://unofficial-hevy-mcp.up.railway.app/mcp",
      "headers": { "X-HEVY-API-KEY": "<your api key>" }
    }
  }
}
  3. Save the file — Cursor connects right away. Make sure the hevy toggle is on.

Your API key is never stored.

3 Ask away

  • "How is my bench press progressing this year?"
  • "What are my squat and deadlift PRs?"
  • "Build me a 3-day push/pull/legs routine and save it to Hevy."
  • "Log today's workout: 5x5 squats at 120 kg…"

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…