Skip to main content
The Hevy HTTP MCP server provides tools for browsing exercise templates. Exercise templates are the foundational exercises available in Hevy (e.g., “Bench Press”, “Squat”, “Deadlift”). You’ll need exercise template IDs when creating workouts and routines.

​
get-exercise-templates

Fetch a paginated list of exercise templates available in Hevy.

​
Parameters

​
page
number
Page number (default: 1)
​
pageSize
number
Items per page (default: 10, max: 100)

​
Response

​
page
number
Current page number
​
page_count
number
Total number of pages available
​
exercise_templates
array
Array of exercise template objects

​
Example

{
  "page": 1,
  "pageSize": 10
}

​
get-exercise-template

Get a single exercise template by its ID.

​
Parameters

​
templateId
string
required
The exercise template ID

​
Response

Returns a single exercise template object with the same structure as described in get-exercise-templates.

​
Example

{
  "templateId": "770e8400-e29b-41d4-a716-446655440002"
}

​
Exercise Types

Exercise templates have different types based on how they’re tracked:
Traditional strength training exercises tracked by weight and repetitions.Examples: Bench Press, Squat, Deadlift, Bicep CurlsFields used: weight_kg, reps, rpe
Exercises tracked by time duration only.Examples: Plank, Wall Sit, Dead HangFields used: duration_seconds
Cardio exercises tracked by distance and time.Examples: Running, Cycling, RowingFields used: distance_meters, duration_seconds
Exercises tracked by weight and distance.Examples: Farmer’s Walk, Sled PushFields used: weight_kg, distance_meters

​
Finding Exercise Templates

When creating workouts or routines, you need to specify the exercise_template_id. Here’s how to find the right template:
  1. Browse all templates: Use get-exercise-templates with a large page size to see available exercises
  2. Search by name: Look through the results for exercises matching your desired movement
  3. Note the ID: Copy the id field to use when creating workouts or routines
  4. Check the type: Ensure you’re using the correct fields for the exercise type

​
Example Workflow

// Request
{
  "page": 1,
  "pageSize": 100
}

// Response - find "Bench Press (Barbell)" in the list
{
  "exercise_templates": [
    {
      "id": "770e8400-e29b-41d4-a716-446655440002",
      "title": "Bench Press (Barbell)",
      "type": "weight_reps",
      ...
    }
  ]
}

​
Custom Exercise Templates

Exercise templates with is_custom: true are user-created exercises. These work identically to built-in exercises and can be used in workouts and routines the same way. To identify custom exercises: 
{
  "id": "cc0e8400-e29b-41d4-a716-446655440099",
  "title": "My Custom Exercise",
  "type": "weight_reps",
  "primary_muscle_group": "Arms",
  "secondary_muscle_groups": [],
  "is_custom": true  // This indicates a custom exercise
}

Build docs developers (and LLMs) love

Get started for freeTalk to us