set_heart_rate_zones
Set account-level Garmin Connect heart-rate training zones for one sport using max HR, heart-rate reserve, LTHR, or custom BPM while preserving omitted settings.
Instructions
Set an account-level heart-rate training-zone configuration for one sport.
WARNING: This mutates the user's Garmin Connect account configuration.
Garmin stores zones per sport, so DEFAULT (the generic fallback),
RUNNING, CYCLING, and other sport profiles are independent. Only the
requested sport is written; omitted values are read from that sport's
current configuration and preserved.
This change affects future activity recording and zone-based training.
It does NOT retroactively re-slice already-recorded activities: their
heart-rate zone boundaries were baked in when those activities were
recorded.
The calculation method may be max_hr (% maximum heart rate), hrr or
karvonen (% heart-rate reserve), lthr (% lactate-threshold heart rate),
or custom_bpm. Manual zone_boundaries are only accepted with the
custom_bpm method. Garmin's API does not persist a separate CUSTOM enum:
direct-BPM zones are sent and read back with trainingMethod=HR_MAX while
the explicit zone floors remain authoritative.
Changing the method or reference heart rates preserves the existing
zone floors; this tool does not calculate new percentage-based floors.
The tool performs a read-modify-write and then re-fetches the requested
sport. Its result is the configuration Garmin actually saved, not the
request payload. If verification fails after Garmin accepts the write,
it reports success with write_committed=true, a confirmation_error, and
the submitted_configuration. Re-read the profile before another update.
Args:
sport: Garmin sport key, e.g. default/generic, running, or cycling.
max_hr: Maximum heart rate in BPM.
resting_hr: Resting heart rate in BPM. Supplying it disables Garmin's
resting-HR auto-update for this zone profile.
lactate_threshold_hr: Lactate-threshold heart rate (LTHR) in BPM.
calculation_method: max_hr, hrr/karvonen, lthr, or custom_bpm.
zone_boundaries: Five strictly increasing BPM floors [Z1, Z2, Z3,
Z4, Z5]. Every floor must be at most max_hr.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"sport": "<sport>"
},
"name": "set_heart_rate_zones"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sport | Yes | ||
| max_hr | No | ||
| resting_hr | No | ||
| zone_boundaries | No | ||
| calculation_method | No | ||
| lactate_threshold_hr | No |