Your AI personal trainer
inside Claude

Connect Claude to Hevy. Log workouts, build routines, track goals, and get coaching — on web and mobile.

View on GitHub Quick setup
Cloudflare Workers MCP (Model Context Protocol) Claude Web + Mobile Hevy PRO Free to deploy Secret token auth

15 tools, zero friction

Workouts

list_workoutsPaginated list of logged workouts, newest first
get_workoutFull details of a single workout by ID
get_workout_countTotal number of workouts logged
log_workoutLog a completed workout with exercises and sets

Routines

list_routinesPaginated list of saved workout routines
get_routineFull details of a single routine by ID
create_routineCreate a new routine with exercises and sets
update_routineEdit an existing routine — replaces all exercises and sets

Exercise Templates

list_exercise_templatesBrowse all exercise templates to find template IDs
get_exercise_templateDetails of a single exercise template by ID

Routine Folders

list_routine_foldersList all routine folders
create_routine_folderCreate a new routine folder

Profile & Goals — persistent across sessions

get_profileRetrieve stored profile — age, weight, experience, injuries, schedule
update_profileUpdate profile fields; omitted fields are kept as-is
list_goalsList all training goals
set_goalAdd a goal with exercise, target, and optional deadline
delete_goalRemove a goal by ID

Setup in 5 minutes

1

Clone and install

Requires Node.js 18+ and a free Cloudflare account.

git clone https://github.com/liggardap/hevy-mcp cd hevy-mcp npm install --ignore-scripts
2

Log in to Cloudflare

npx wrangler login
3

Store your secrets

Hevy API key — get it at hevy.com/settings?developer (Hevy PRO required).

npx wrangler secret put HEVY_API_KEY

MCP secret token — guards the server URL.

openssl rand -hex 16 | pbcopy # copies token to clipboard npx wrangler secret put MCP_SECRET
4

Deploy

npx wrangler deploy

Prints your URL: https://hevy-mcp.<subdomain>.workers.dev

5

Connect to Claude

On claude.ai → Settings → Connectors → Add custom connector

https://hevy-mcp.<subdomain>.workers.dev/sse/<your-MCP_SECRET>

The secret token is the only thing protecting your Hevy data — keep the URL private. Once added on the web, the connector also appears in Claude Mobile.

What you can ask Claude

"Set up my profile: 26 years old, 75 kg, intermediate lifter, training 4 days a week."
"Based on my last 3 Pull Day workouts, am I progressing on Bent Over Row?"
"My goal is Bench Press 3×8 @ 70 kg by end of June. Am I on track?"
"Create a Push/Pull/Legs routine based on the exercises I use most."
"Log today's Push Day: 9:00–10:05 AM, Bench Press 4×35 kg, Shoulder Press 3×14 kg."
"I haven't trained in 5 days. Should I deload or push today?"