> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chrisdoc.dev/hevy-mcp/llms.txt
> Use this file to discover all available pages before exploring further.
# Hevy MCP tools reference — all 25 available tools
> Complete reference for all 25 Hevy MCP tools organized by category: training analysis, workouts, routines, exercise templates, body measurements, and account.
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
7 tools for reading, logging, and editing workouts, plus the `get-training-summary` workflow.
5 tools for searching, reading, and creating reusable workout routines.
5 tools for browsing and creating the exercise catalog, including full-text search.
4 tools for reading and recording dated body measurements.
1 tool returning the authenticated user's ID, display name, and profile URL.