create_run_interval_workout
Build a repeat-based interval run workout (warmup, work reps with jog recovery, cooldown) and upload it to Garmin Connect, with optional custom heart-rate targets.
Instructions
Create a repeat-based interval run workout and upload it to Garmin Connect.
Builds warmup -> repeats x [work interval + jog recovery] -> cooldown. Use this
instead of create_run_workout whenever the session has more than one work
interval (threshold reps, VO2 intervals, cruise intervals, strides).
Work intervals target a named heart-rate zone by default, but named zones are
usually far too wide for interval work: a threshold session at 172-180 bpm sits
inside a Z3 that may span 158-184. Pass hr_min and hr_max together to target the
exact bpm range, so the watch alerts as soon as the effort drifts off target.
Recovery steps carry no target unless recovery_hr_min/max are given -- a capped
recovery alerts constantly right after a hard rep, since heart rate lags effort.
Recovery HR bounds require recovery_seconds > 0.
Example -- 3 x 6 min at HR 172-180 with 3 min jogs, 12m warmup, 8m cooldown:
repeats=3, rep_seconds=360, recovery_seconds=180,
hr_min=172, hr_max=180, warmup_min=12, cooldown_min=8
Args:
name: Workout name (e.g. "Threshold 3x6min")
repeats: Number of work intervals
rep_seconds: Duration of each work interval in seconds
recovery_seconds: Jog recovery between work intervals in seconds (0 to omit)
warmup_min: Warmup duration in minutes
cooldown_min: Cooldown duration in minutes
hr_zone: Target zone for the work intervals (Z1-Z5, default Z4). Ignored if hr_min/hr_max are given.
hr_min: Custom target HR range for the work intervals, minimum bpm (with hr_max)
hr_max: Custom target HR range for the work intervals, maximum bpm (with hr_min)
recovery_hr_min: Optional HR range for recovery jogs, minimum bpm (with recovery_hr_max)
recovery_hr_max: Optional HR range for recovery jogs, maximum bpm (with recovery_hr_min)
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": {
"name": "<name>",
"repeats": "<repeats>",
"rep_seconds": "<rep_seconds>",
"recovery_seconds": "<recovery_seconds>",
"warmup_min": "<warmup_min>",
"cooldown_min": "<cooldown_min>"
},
"name": "create_run_interval_workout"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| hr_max | No | ||
| hr_min | No | ||
| hr_zone | No | Z4 | |
| repeats | Yes | ||
| warmup_min | Yes | ||
| rep_seconds | Yes | ||
| cooldown_min | Yes | ||
| recovery_hr_max | No | ||
| recovery_hr_min | No | ||
| recovery_seconds | Yes |