super-hevy-mcp

MCP server for the Hevy workout tracker — full API coverage, built for serious lifters. Ask Claude about your training history, log workouts, and manage routines straight from chat.

Requirements

• Node.js 20+
• A Hevy Pro subscription (the Hevy API requires Pro)
• A Hevy API key: https://hevy.com/settings?developer

Setup

Claude Code

claude mcp add super-hevy -e HEVY_API_KEY=<your-key> -- npx -y super-hevy-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "super-hevy": {
      "command": "npx",
      "args": ["-y", "super-hevy-mcp"],
      "env": { "HEVY_API_KEY": "<your-key>" }
    }
  }
}

Tools (v0.1)

Tool	Description
get-user-info	Your Hevy profile
list-workouts	Logged workouts, most recent first (limit up to 100)
get-workout	One workout with all exercises and sets
get-workout-count	Total workouts on the account
get-workout-events	Workout updates/deletes since a date (for syncing)
create-workout	Log a completed workout
update-workout	Replace a workout's contents
list-routines	Saved routines (limit up to 100)
get-routine	One routine with prescribed sets
create-routine	Create a routine
update-routine	Replace a routine's contents

Weights are kilograms. Workout sets accept RPE (6-10); routine sets accept rep_range targets. Responses are trimmed (no null noise) to keep context lean.

Coming next: exercise templates, routine folders, exercise history, body measurements — then bodybuilding-focused analysis tools.

Development

npm install
npm test          # unit + integration tests (mocked HTTP)
npm run smoke     # end-to-end against the real API (needs HEVY_API_KEY)
npm run build

License

MIT