Hevy MCP registers 25 tools across 6 categories. Read-only tools are safe for exploration and carry no risk of data change. Mutation tools — those that create or update data — are annotated with MCP mutation hints so compatible clients (such as Claude Desktop and Cursor) can surface a confirmation step before executing them.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/chrisdoc/hevy-mcp/llms.txt
Use this file to discover all available pages before exploring further.
Tool categories
| Category | Tool | Description |
|---|---|---|
| Training analysis | get-training-summary | Summarize 1–12 weeks of workout activity and body-measurement trends in one call. |
| Workouts | get-workouts | List workouts from newest to oldest with exercise and timing details. |
| Workouts | get-workout | Get complete details for one workout by ID. |
| Workouts | get-workout-count | Return the account’s total workout count. |
| Workouts | get-workout-events | List workout update and delete events since a timestamp. |
| Workouts | create-workout | Create a completed workout in Hevy. |
| Workouts | update-workout | Replace an existing workout by ID. |
| Routines | search-routines | Search routine titles and return compact metadata for discovery. |
| Routines | get-routines | List custom and default workout routines. |
| Routines | get-routine | Get one routine and its exercise configuration by ID. |
| Routines | create-routine | Create a reusable workout routine. |
| Routines | update-routine | Replace an existing routine’s content. |
| Routine folders | get-routine-folders | List default and custom routine folders. |
| Routine folders | get-routine-folder | Get one routine folder’s metadata by ID. |
| Routine folders | create-routine-folder | Create a routine folder. |
| Exercise templates | get-exercise-templates | List exercise templates with equipment and muscle metadata. |
| Exercise templates | get-exercise-template | Get complete metadata for one exercise template by ID. |
| Exercise templates | search-exercise-templates | Search the full exercise catalog by title substring. |
| Exercise templates | create-exercise-template | Create a custom exercise template. |
| Exercise history | get-exercise-history | Get past performed sets for one exercise template. |
| Body measurements | get-body-measurements | List dated body measurements. |
| Body measurements | get-body-measurement | Get the body measurement entry for one date. |
| Body measurements | create-body-measurement | Create a dated body measurement. |
| Body measurements | update-body-measurement | Update the body measurement for an existing date. |
| Account | get-user-info | Return the user’s ID, display name, and public profile URL. |
Read vs Write tools
Read-only tools
Tools whose names start withget- or search- carry readOnlyHint: true in their MCP annotations. These tools only retrieve data from the Hevy API and produce no side effects. You can call them freely during exploration without worrying about modifying your account.
Mutation tools
Create tools (create-*) and update tools (update-*) carry readOnlyHint: false in their annotations. In addition:
- Create tools set
idempotentHint: false— retrying can produce duplicate records. - Update tools set
destructiveHint: trueandidempotentHint: true— they perform a full PUT-style replacement of the existing record, but repeating the same call yields the same result.
There are no delete tools in Hevy MCP. The Hevy API does not expose delete endpoints for workouts, routines, routine folders, exercise templates, or body measurements, so no corresponding tools exist.
Pagination
All list tools accept two optional parameters for controlling the result window:| Parameter | Description | Default |
|---|---|---|
page | Page number, starting at 1. | 1 |
pageSize | Number of items per page. | Varies by tool (see below). |
pageSize: 5 and enforce a maximum of 10 items per page. The get-exercise-templates tool is the exception — it allows up to 100 items per page, making it efficient for bulk catalog retrieval.
Quick links
Workouts
7 tools for reading, logging, and editing workouts, plus the
get-training-summary workflow.Routines
5 tools for searching, reading, and creating reusable workout routines.
Exercise Templates
5 tools for browsing and creating the exercise catalog, including full-text search.
Body Measurements
4 tools for reading and recording dated body measurements.
Account
1 tool returning the authenticated user’s ID, display name, and profile URL.