Skip to main content
Hevy MCP provides 4 tools for reading and writing dated body measurements. Each entry is keyed to a calendar date and can store weight, lean mass, body fat percentage, and a full set of circumference measurements. The tools cover the complete lifecycle: browse history, look up a specific date, log a new entry, and correct an existing one.

get-body-measurements

Lists dated body measurements for the account, returned from newest to oldest. Use this tool to browse measurement history or retrieve multiple entries in one call. Kind: Read-only
integer
default:"1"
Page number to retrieve, starting at 1.
integer
default:"10"
Number of measurements to return per page. Maximum is 10.
Results are paginated. page starts at 1 and pageSize is capped at 10. Iterate with incrementing page values to walk through the full history.

get-body-measurement

Retrieves the body measurement entry for a single specific date. Use this tool when the exact measurement date is already known. For browsing or discovering dates, use get-body-measurements instead. Kind: Read-only
string
required
The date of the body measurement to retrieve, in YYYY-MM-DD format. Example: 2024-03-15.
At most one measurement entry exists per date. If no entry exists for the supplied date, the tool returns a null body measurement rather than an error.

create-body-measurement

Creates a new dated body measurement on the Hevy account. Supply the date and at least one numeric measurement field. Use this tool only for dates that do not yet have an entry; to modify an existing entry use update-body-measurement. Kind: Write (mutation)
string
required
The date for the new measurement, in YYYY-MM-DD format. Must be unique — no measurement entry may already exist for this date.
float
Body weight in kilograms.
float
Lean body mass in kilograms.
float
Body fat percentage.
float
Neck circumference in centimeters.
float
Shoulder circumference in centimeters.
float
Chest circumference in centimeters.
float
Left bicep circumference in centimeters.
float
Right bicep circumference in centimeters.
float
Left forearm circumference in centimeters.
float
Right forearm circumference in centimeters.
float
Abdomen circumference in centimeters.
float
Waist circumference in centimeters.
float
Hips circumference in centimeters.
float
Left thigh circumference in centimeters.
float
Right thigh circumference in centimeters.
float
Left calf circumference in centimeters.
float
Right calf circumference in centimeters.
If an entry already exists for the supplied date, the Hevy API returns 409 Conflict. Use update-body-measurement to modify an existing entry instead.
Fields set to null or omitted are not sent to the API and cannot be used to clear previously stored values. To change an existing value, use update-body-measurement with the new numeric value.

update-body-measurement

Updates the body measurement for a date that already has an existing entry. Supply date and at least one numeric field to change. To create an entry for a date that has no record yet, use create-body-measurement. Kind: Write (mutation)
string
required
The date of the measurement to update, in YYYY-MM-DD format. An entry must already exist for this date.
float
Body weight in kilograms.
float
Lean body mass in kilograms.
float
Body fat percentage.
float
Neck circumference in centimeters.
float
Shoulder circumference in centimeters.
float
Chest circumference in centimeters.
float
Left bicep circumference in centimeters.
float
Right bicep circumference in centimeters.
float
Left forearm circumference in centimeters.
float
Right forearm circumference in centimeters.
float
Abdomen circumference in centimeters.
float
Waist circumference in centimeters.
float
Hips circumference in centimeters.
float
Left thigh circumference in centimeters.
float
Right thigh circumference in centimeters.
float
Left calf circumference in centimeters.
float
Right calf circumference in centimeters.
If no entry exists for the supplied date, the Hevy API returns 404 Not Found. Use create-body-measurement to create a new entry for that date first.
You must provide at least one numeric measurement field; calling this tool with only date and no measurement fields is rejected. Fields set to null are omitted and cannot clear previously stored values — only supplying a new numeric value overwrites an existing one.

Date format

All body measurement tools use calendar dates in YYYY-MM-DD format — for example, 2024-03-15. There is no time component. The Hevy API enforces a strict one-entry-per-date constraint, so the date acts as the unique key for every measurement record.

Measurement fields

All numeric fields are optional on both create-body-measurement and update-body-measurement. You may record any combination that is relevant to a given weigh-in.