Hevy (Unofficial) MCP Server

Create Hevy routines and analyze your training from chat. Unofficial; BYO Hevy PRO API key.

Remote serverstreamable-http

What is the Hevy (Unofficial) MCP Server?

Create Hevy routines and analyze your training from chat. Unofficial; BYO Hevy PRO API key.

What the server does

Unofficial MCP server for Hevy. Design training programs in chat; your AI creates the routines directly in your Hevy account and analyzes your logged training. Requires a Hevy PRO API key (hevy.com/settings?developer).

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
search_exercisesSearch the user's Hevy exercise library by name (fuzzy). Returns template id, exact title, type, muscle group and equipment.
list_routine_foldersList the user's routine folders (id + title). Check this before creating a folder — reuse an existing one when the name matches.
create_routine_folderCreate a routine folder, or return the existing folder if one with this exact title already exists (never duplicates).
list_routinesList the user's existing routines (id, title, folder_id, exercise_count). Use to avoid creating duplicates.
create_routinecreate a routine (lb-first: weight_lb snaps to 2.5/5 lb increments; RPE folded into notes; supersets; duration/distance targets supported)
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.
get_workoutGet one logged workout with every set (weights in kg). Use the id from get_workouts.
get_workout_countTotal number of workouts the user has ever logged in Hevy.
get_exercise_historypast sets + estimated 1RM in lb for one exercise (full history, optional date range)
get_routineGet one routine in full (all exercises and sets). Always call this before update_routine so you can send back the complete routine.
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
get_training_summaryweekly sessions/volume (lb), sets per muscle group, top-lift 1RM trend

How to install the Hevy (Unofficial) MCP Server

{
  "mcpServers": {
    "hevy": {
      "command": "npx",
      "args": ["-y", "@almostjacked/hevy-mcp"],
      "env": {
        "HEVY_API_KEY": "your-value",
        "AUTH_TOKEN": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
HEVY_API_KEYCredential the server authenticates with.Yes
AUTH_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • “Use Hevy (Unofficial) to search exercises.”
  • “Use Hevy (Unofficial) to list routine folders.”
  • “Use Hevy (Unofficial) to create routine folder.”

Frequently asked questions

Create Hevy routines and analyze your training from chat. Unofficial; BYO Hevy PRO API key. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.