Sleep duration, sleep stages, sleep score, and overnight HRV.

Args: date: Calendar date in YYYY-MM-DD format. Defaults to last night (yesterday). Pass today's date to get the most recent recorded sleep when you wake up.

List recent activities with type, duration, distance, and average heart rate.

Args: limit: How many of the most recent activities to return. Capped at 50.

Detailed metrics for one activity, including splits and HR zones.

Args: activity_id: The activity's numeric Garmin ID, as returned by get_recent_activities.

Daily training load with acute and chronic load and current status.

Args: days: Number of recent days to summarise. Capped at 28.

Current HRV status, baseline range, and the last 7 nights of readings.

Body battery values across the day, plus min, max, charged, and drained totals.

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today.

Daily step total, distance, calories, floors, and intensity minutes.

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today.

Resting heart rate trend over the last days days.

Args: days: How many recent days to include. Capped at 28.

Stress levels across the day with average, max, and time-in-zone breakdown.

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today.

Daily training readiness score (0-100) with contributing factors.

The score reflects how prepared the user is to train, drawing on sleep, HRV status, recovery time, and recent training load.

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today.

One-call morning snapshot: sleep, HRV, Body Battery, readiness, load, and RHR.

Fuses the individual recovery and training-load tools into a single payload so you can reason across them in one shot instead of making six separate calls. Each section is fetched independently and concurrently; a section that fails comes back null and is named in sections_unavailable rather than failing the whole briefing. Also returns rhr_vs_baseline_bpm, the most recent resting HR relative to its trailing average.

The server returns facts only and computes no training advice — interpret the numbers yourself (e.g. weigh readiness, HRV status, and Body Battery together).

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today. The sleep, Body Battery, and training-readiness sections honour this date; the HRV, training-load, and resting-HR sections always report their own most-recent trailing window. For the default (this-morning) call everything lines up; passing a past date yields a mixed snapshot.

VO2 max (running and cycling), fitness age, and predicted race times.

Combines Garmin's "max metrics" tile (VO2 max, fitness age) with current race-time predictions for 5K, 10K, half marathon, and marathon.

Args: date: Calendar date for the VO2 max snapshot in YYYY-MM-DD format. Defaults to today.

Personal records across activity types (fastest 1K/5K/10K, longest run, etc.).

Weight, body fat, and muscle-mass trend over recent days.

Returns one row per day Garmin has a reading for, plus the latest weight and average over the window.

Args: end_date: End of the window in YYYY-MM-DD format. Defaults to today. days: Window size in days. Capped at 90.

Daily respiration rate: average, min, max, and waking vs. sleeping averages.

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today.

Weekly aggregates for a single metric.

Args: metric: One of "steps", "stress", or "intensity_minutes". weeks: How many recent weeks to include. Capped at 12. end_date: End of the window in YYYY-MM-DD format. Defaults to today.

Set-by-set breakdown of a logged strength session: exercises, reps, and weight.

Parses Garmin's recorded sets for one strength_training activity into working sets (with the recognised exercise, rep count, and load) plus a per-exercise rollup and total training volume. Rest periods are included and flagged. Sets Garmin could not classify come back with a null exercise name.

Args: activity_id: The activity's numeric Garmin ID, from get_recent_activities.

Garmin endurance score with its activity-type contributors.

The endurance score reflects accumulated aerobic capacity across activities. It only updates after qualifying activities, so a given day may have no value.

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today.

Garmin hill score (climbing strength + endurance) for a date.

Combines a strength and an endurance component into an overall hill score. Requires qualifying climbing efforts, so it is often empty for flat-terrain athletes — an empty result is reported via note rather than an error.

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today.

Weather conditions recorded during an activity (temp, humidity, wind).

Units follow your Garmin account's measurement system (US accounts report degrees Fahrenheit and mph).

Args: activity_id: The activity's numeric Garmin ID, from get_recent_activities.

Assemble a strength workout and show what WOULD be created — no network call.

Resolves each exercise name to Garmin's catalog and returns a readable summary, the resolved Garmin name + confidence per exercise, warnings for anything that did not map cleanly, and a confirmation_token to pass to create_strength_workout. Always call this first and review the result.

Args: workout: the workout definition (name, blocks of sets/exercises).

Create a strength workout in your Garmin Connect library (a WRITE).

Requires writes to be enabled (GARMIN_WRITE_ENABLED) and a matching confirmation_token from preview_strength_workout (it binds to the exact workout previewed). The workout lands in your library — it reaches the watch only after you "Send to Device" in Garmin Connect and sync.

Args: workout: the workout definition (same shape as preview). confirmation_token: token returned by preview_strength_workout. confirm: dev/stdio only (no JWT secret) — set True to confirm.

List workouts saved in your Garmin Connect library (id, name, sport).

These are workout templates in the library — the source the watch syncs from — not logged activities. Use the ids with delete_workout.

Args: limit: maximum number of workouts to return (default 50).

Delete ONE workout from your Garmin Connect library (a WRITE, irreversible).

Preview-then-confirm: call without a token first — that call deletes nothing and returns the workout's name plus a confirmation_token. Review the name, then call again with the token to actually delete. Deleting from the library also removes the workout from the watch on its next sync. There is no bulk delete; confirm each workout individually.

Args: workout_id: id from list_workouts. confirmation_token: token from the preview call for this same id. confirm: dev/stdio only (no JWT secret) — set True to confirm.

Assemble a running workout and show what WOULD be created — no network call.

Validates the structure (one end condition per step, paired pace bounds, pace format) and returns a readable summary, sanity warnings, and a confirmation_token to pass to create_running_workout. Always call this first and review the result.

Args: workout: the workout definition (name, steps and/or repeat groups).

Create a structured running workout in your Garmin Connect library (a WRITE).

Supports warmup/cooldown/interval/recovery steps, repeat groups for intervals, and optional pace targets ('M:SS' per km). Requires writes to be enabled (GARMIN_WRITE_ENABLED) and a matching confirmation_token from preview_running_workout. The workout lands in your library — get it on the watch via schedule_workout (syncs automatically for that date) or "Send to Device" in Garmin Connect.

Args: workout: the workout definition (same shape as preview). confirmation_token: token returned by preview_running_workout. confirm: dev/stdio only (no JWT secret) — set True to confirm.

Put an existing library workout on a Garmin Connect calendar date (a WRITE).

Works for any workout type (running, strength, ...). A scheduled workout is pushed to the watch automatically on its next sync — no "Send to Device" needed. Reversible with unschedule_workout.

Args: workout_id: id from create_running_workout / create_strength_workout / list of workouts in Garmin Connect. date: calendar date, YYYY-MM-DD.

Remove a scheduled workout from the calendar (a WRITE; keeps the template).

The workout stays in your library — only the calendar entry is removed.

Args: schedule_id: id returned by schedule_workout.

Intraday heart rate for a day, including the most recent reading the watch synced.

Use this for "what is my heart rate now / this morning / at 15:30". The last_reading fields give the newest value Garmin has; readings are downsampled to ~max_points evenly spaced samples.

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today. max_points: Maximum number of readings to return (default 96, i.e. ~15 min apart).

Everything Garmin records for one day in a single call.

Steps, distance, calories (active/BMR/total), floors, intensity minutes, heart rate (resting/min/max/last), stress, Body Battery, SpO2, respiration, sleep seconds and more. Best first call for "how was my day".

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today.

Steps in 15-minute buckets across the day, with activity level per bucket.

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today.

Floors climbed and descended for a day, with the intraday timeline.

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today.

Moderate and vigorous intensity minutes for a day and the weekly goal progress.

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today.

Blood oxygen (SpO2 / pulse ox) for a day: average, lowest, latest, sleep average, timeline.

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today.

Hydration log for a day: intake in ml, goal, sweat loss estimate.

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today.

Body Battery charge/drain events for a day (sleep, activities, stress) with their impact.

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today.

Timeline of everything Garmin detected during the day: activities, naps, sleep, stress events.

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today.

Daily stats merged with body composition (weight, BMI, body fat) for a date.

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today.

Lifestyle logging entries for a day (caffeine, alcohol, illness, travel, mood, etc.).

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today.

Food log and meals for a day (calories, macros) if nutrition tracking is used.

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today.

Menstrual cycle tracking data for a date, if the feature is used.

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today.

Steps, distance and step goal per day over a date range (default last 14 days).

Args: start_date: YYYY-MM-DD. Defaults to 14 days ago. end_date: YYYY-MM-DD. Defaults to today.

Every weigh-in (weight, BMI, body fat, muscle mass...) in a date range (default last 30 days).

Args: start_date: YYYY-MM-DD. Defaults to 30 days ago. end_date: YYYY-MM-DD. Defaults to today.

Blood pressure readings logged in Garmin Connect over a date range (default last 30 days).

Args: start_date: YYYY-MM-DD. Defaults to 30 days ago. end_date: YYYY-MM-DD. Defaults to today.

Totals per activity type between two dates: distance, duration, elevation gain or moving time.

Use for "how many km did I run this month" or "hours of cycling this year".

Args: start_date: YYYY-MM-DD. Defaults to 30 days ago. end_date: YYYY-MM-DD. Defaults to today. metric: One of distance, duration, movingDuration, elevationGain, elevationLoss.

Garmin running tolerance (weekly mileage your body tolerates) over a range (default 12 weeks).

Args: start_date: YYYY-MM-DD. Defaults to 84 days ago. end_date: YYYY-MM-DD. Defaults to today.

Activities between two dates, optionally filtered by type (running, cycling, swimming, ...).

Args: start_date: YYYY-MM-DD. Defaults to 30 days ago. end_date: YYYY-MM-DD. Defaults to today. activity_type: Garmin type key such as running, cycling, walking, strength_training.

The most recent activity recorded, with its summary metrics.

Second-by-second chart data of an activity as named series (heart rate, pace, altitude, cadence, power, temperature...), downsampled to max_points.

Args: activity_id: Garmin activity ID (from get_recent_activities). max_points: Maximum samples per series (default 120).

Time spent in each power zone for a cycling or running-power activity.

Args: activity_id: Garmin activity ID.

Per-split summaries of an activity (laps, intervals, rest) with pace, HR and power.

Args: activity_id: Garmin activity ID.

Typed splits of an activity (e.g. climb/descent segments, swim lengths, interval work/rest).

Args: activity_id: Garmin activity ID.

Gear (shoes, bike) linked to an activity.

Args: activity_id: Garmin activity ID.

Latest lactate threshold estimate (heart rate and pace/power) from Garmin.

Cycling Functional Threshold Power (FTP) and power zones.

Garmin fitness age with its components (VO2 max, BMI/body fat, RHR, vigorous days).

Args: date: Calendar date in YYYY-MM-DD format. Defaults to today.

Training calendar for a month: scheduled workouts, completed activities, plan items.

Args: year: Four-digit year. Defaults to the current year. month: 1-12. Defaults to the current month.

Training plans the user is enrolled in (Garmin Coach and custom plans).

Goals set in Garmin Connect (steps, distance, weight...) with progress.

Args: status: active, future or past. Defaults to active.

Badges earned and badges in progress, with points and dates.

Registered Garmin devices and the last-used device with its last sync time.

Use this to know how fresh the data is: if the watch has not synced recently, intraday values will be stale.

Gear registered in Garmin Connect (shoes, bikes) with total distance and activity counts.

User profile basics: display name, unit system, birth year, gender, height, weight.