About Hevy (unofficial)
Hevy (unofficial) is an MCP server published by almostjacked in the Developer Tools category: create Hevy routines and analyze your training from chat. Unofficial; BYO Hevy PRO API key.
Recent commit activity is the strongest signal that reported issues will get attention.
Install
claude mcp add hevy-unofficial -- npx -y @almostjacked/hevy-mcpnpx -y @almostjacked/hevy-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (12)
create_routinecreate a routine (lb-first: weight_lb snaps to 2.5/5 lb increments; RPE folded into notes; supersets; duration/distance targets supported)
Parameters not published.
create_routine_folderCreate a routine folder, or return the existing folder if one with this exact title already exists (never duplicates).
Parameters not published.
get_exercise_historypast sets + estimated 1RM in lb for one exercise (full history, optional date range)
Parameters not published.
get_routineGet one routine in full (all exercises and sets). Always call this before update_routine so you can send back the complete routine.
Parameters not published.
get_training_summaryweekly sessions/volume (lb), sets per muscle group, top-lift 1RM trend
Parameters not published.
get_workoutGet one logged workout with every set (weights in kg). Use the id from get_workouts.
Parameters not published.
get_workout_countTotal number of workouts the user has ever logged in Hevy.
Parameters not published.
get_workoutsGet the user's most recent logged workouts, newest first, as compact summaries: title, date, duration, and per-exercise set count + top set. Use get_workout for full set-by-set detail of one workout.
Parameters not published.
list_routine_foldersList the user's routine folders (id + title). Check this before creating a folder — reuse an existing one when the name matches.
Parameters not published.
list_routinesList the user's existing routines (id, title, folder_id, exercise_count). Use to avoid creating duplicates.
Parameters not published.
search_exercisesSearch the user's Hevy exercise library by name (fuzzy). Returns template id, exact title, type, muscle group and equipment.
Parameters not published.
update_routineReplace an existing routine. WARNING: this overwrites the routine — Hevy replaces its exercises with exactly what you send, so first call get_routine and include every exercise you want to keep. Folder cannot be changed here; duration/distance/custom-metric set targets round-trip safely.
Parameters not published.
Ask AI
Ask AI about Hevy (unofficial)
Powered by Claude · Grounded in docs
Security checks
6 checks have not been run yet.