The user's Garmin profile settings (units, weight, height, birth year, lactate threshold where set) plus their heart-rate zones. Call this first when you need zones or units to interpret other data.

List recorded activities (runs, gym sessions, rides…), newest first, with distance, time, pace, heart rate, training effect and Garmin's training load.

Examples:

• "my runs this month" -> start_date="2026-10-01", activity_type="running"

• "last 5 activities" -> limit=5 Use garmin_get_activity_splits on an activity_id for per-km splits and pacing.

Garmin's computed summary for one activity: distance, durations, pace/speed, HR, cadence, elevation, training effect, calories. For per-km splits use garmin_get_activity_splits.

Downloads the original .FIT recording and computes exact distance splits (default 1 km, interpolated at each boundary, pauses excluded), per-split HR, cadence and climb, the device laps, and a pacing verdict (even, negative split, faded).

Use this for "how was my pacing", "did I go out too fast", "compare km 1 to km 5". Works for any GPS or footpod activity recorded on a Garmin device.

Garmin's own VO2 max, read the way Garmin Connect shows it, plus per-activity aerobic/anaerobic training effect, recovery time and performance condition. Decoded from the original .FIT files, since the Personal API has no VO2 max endpoint.

Returns the current VO2 max (whole number, as Garmin's apps round it, plus the precise value), every new VO2 max reading in the window (Garmin only updates it on qualifying runs and power-meter rides), and a row per activity.

Examples:

• "what's my VO2 max?" / "how is my VO2 max trending?" -> last_n=20

• "how hard was today's workout, how long to recover?" -> last_n=1 Each activity costs one file download, so keep last_n small unless a trend is asked for.

Saves an activity's original file (Garmin's ZIP containing the .fit) to a folder on this computer, for import into other tools such as Runalyze or Golden Cheetah. Returns the saved path.

Everything for one day in one call: daily summary (steps, calories, resting HR, stress, intensity minutes), sleep, overnight HRV, Body Battery and activities. Best first call for 'how recovered am I today' or 'how was yesterday'. Parts Garmin has no data for are omitted.

Per-day totals: steps, distance, active and total calories, resting/min/max heart rate, average and max stress, intensity minutes, floors, Body Battery high/low. Best tool for trends across weeks.

Long ranges are fetched in chunks automatically (up to 366 days).

Per-night sleep: duration, deep/light/REM/awake time, sleep score, and timing.

Long ranges are fetched in chunks automatically (up to 366 days).

Per-night heart-rate variability: last-night average, weekly average, baseline range and status (balanced, unbalanced, low).

Long ranges are fetched in chunks automatically (up to 366 days).

Per-day Body Battery: charged, drained, highest and lowest values.

Long ranges are fetched in chunks automatically (up to 366 days).

Per-day all-day stress levels.

Long ranges are fetched in chunks automatically (up to 366 days).

Per-day step totals and goals.

Long ranges are fetched in chunks automatically (up to 366 days).

Per-day logged water intake and goal.

Long ranges are fetched in chunks automatically (up to 366 days).

Every weigh-in in the range (Garmin usually reports weight in grams: divide by 1000 for kg), with BMI, body fat, muscle mass and water where a smart scale recorded them. Use for bulk/cut progress.

Long ranges are fetched in chunks automatically (up to 366 days).

Weight goals in effect during the range.

Long ranges are fetched in chunks automatically (up to 366 days).

Wellness activity summaries (e.g. breathwork and relaxation sessions) for the range.

Long ranges are fetched in chunks automatically (up to 366 days).

One night's sleep in full: stages timeline, sleep score breakdown, respiration, restless moments, SpO2 and HR during sleep.

One day's resting HR and the all-day heart-rate samples.

One day's SpO2 readings and acclimation.

Garmin's fitness age estimate and its inputs for a date.

Foods and macros logged in Garmin Connect's nutrition log for one day.

Call any documented Personal API endpoint directly, for data the other tools don't cover (e.g. menstrual cycle summaries, activity workouts). Path must start with one of: /activity-service/, /activitylist-service/, /biometric-service/, /fitnessage-service/, /goal-service/, /hrv-service/, /nutrition-service/, /periodichealth-service/, /sleep-service/, /usersummary-service/, /userprofile-service/, /weight-service/, /wellness-service/, /wellnessactivity-service/. Example: path="/activity-service/activity/123456/workouts"