HEVY MCP

Create routines and workout plans, and analyze your workout data from ChatGPT, Claude, and other MCP clients.

Connect

Production endpoint:

https://mcp.hevy.com/mcp

Claude Connectors may also use the root URL (POST /). Authentication is OAuth through Hevy—sign in when your client prompts you. No API keys required.

To try it in ChatGPT:

  1. Enable Developer Mode under Settings → Apps → Advanced Settings
  2. Go to Settings → Apps → Create App
  3. Set the connection URL to https://mcp.hevy.com/mcp (or your local ngrok URL + /mcp)

What you can do

Typical workflow:

  1. Search exercise templates to get the right IDs
  2. Create a routine, folder, or full plan
  3. Look up past workouts when you want analysis or history

Anything created shows up in your Hevy account.

Tools

get_user_workouts

Fetch your workouts, paginated. Inputs: page (from 1) and pageSize (1–10).

search_hevy_exercises

Search your exercise templates by name. Pass one or more queries in queries. Use this first so routines and plans get the correct exercise_template_id values.

create_hevy_routine

Create a single routine with a title and exercises/sets. Set types: warmup, normal, failure, dropset.

create_hevy_routine_folder

Create a folder to organize routines. Input: folder title.

create_hevy_plan

Create a plan in one step: a folder plus one or more routines (for example an Upper/Lower split). Prefer searching exercises first.

Limits & tips