Hevy MCP tools reference — all 25 available tools

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.

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 with get- 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: true and idempotentHint: true — they perform a full PUT-style replacement of the existing record, but repeating the same call yields the same result.

In clients that respect MCP mutation annotations (such as Claude Desktop or Cursor), these tools will prompt for confirmation before executing.

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).

Most tools default to 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.

Use get-workout-count first to estimate how many pages to expect, then iterate with get-workouts to walk through the full history.

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.

Overview

Workouts

Routines

Exercise Templates

Body Measurements & Account

Hevy MCP tools reference — all 25 available tools

Tool categories

Read vs Write tools

Read-only tools

Mutation tools

Quick links

Workouts

Routines

Exercise Templates

Body Measurements

Account

​Tool categories

​Read vs Write tools

​Read-only tools

​Mutation tools

​Pagination

​Quick links

Workouts

Routines

Exercise Templates

Body Measurements

Account

Tool categories

Read vs Write tools

Read-only tools

Mutation tools

Pagination

Quick links