{"name":"garmlink","version":"0.2.1","generated_at":"2026-11-19T22:18:11.575Z","tools":[{"name":"garmlink_activities_list","title":"List activities","description":"The user's Garmin activities, most recent first, with optional type/date filters. Each row carries the compact basics (id, type, name, start_time, duration_s, distance_m, calories, avg_hr) PLUS a `brief` of sport metrics (avg speed, max HR, elevation gain, SWOLF/strokes for swims, cadence for runs, power for rides) — enough to compare sessions without fetching details. The response's `synced_at` says how fresh the data is. Splits and HR zones are available from garmlink_activities_get, which takes several ids in one call.","domain":"activities","annotations":{"title":"List activities","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"type":{"description":"Activity type key, e.g. running, cycling, swimming, hiking, strength. Matches loosely, so \"running\" also returns trail and treadmill runs — and a walk named \"Running errands\". exact_type matches one type key strictly.","type":"string"},"exact_type":{"description":"Exact activity type, matched strictly: \"running\" here excludes trail_running and treadmill_running, which have different paces, so it gives a like-for-like comparison baseline.","type":"string"},"from":{"description":"ISO date/datetime lower bound on start_time (inclusive).","type":"string"},"to":{"description":"ISO date/datetime upper bound on start_time (inclusive). A date-only bound covers the whole day.","type":"string"},"limit":{"default":50,"description":"Max rows to return (<=200).","type":"integer","minimum":1,"maximum":200},"offset":{"default":0,"description":"Pagination offset.","type":"integer","minimum":0,"maximum":9007199254740991}}}},{"name":"garmlink_activity_get","title":"Get one activity","description":"Full detail for a single activity: the summary (nulls stripped) plus splits, typed splits and HR zones (weather on request via `include`). Several activities at once: garmlink_activities_get (batch form of this tool). Sample-by-sample data: garmlink_activity_timeseries.","domain":"activities","annotations":{"title":"Get one activity","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"activity_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"The garmin_activity_id from garmlink_activities_list."},"include":{"description":"Detail sections to return — the array passed replaces the default [\"splits\",\"typed_splits\",\"hr_zones\"], so a section left out of it is not returned. Weather is served only when asked for (e.g. [\"splits\",\"typed_splits\",\"hr_zones\",\"weather\"], or [\"weather\"] alone for a conditions-only question).","type":"array","items":{"type":"string","enum":["splits","typed_splits","hr_zones","weather"]}}},"required":["activity_id"]}},{"name":"garmlink_activities_get","title":"Get several activities at once","description":"Batch form of garmlink_activity_get: full detail for up to 20 activities in one call — summaries (nulls stripped) plus splits, typed splits and HR zones per activity (weather via `include`). One round trip covers all the ids. Ids the user does not own come back in `not_found`.","domain":"activities","annotations":{"title":"Get several activities at once","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"activity_ids":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"description":"garmin_activity_ids from garmlink_activities_list, returned in the order given."},"include":{"description":"Detail sections to return — the array passed replaces the default [\"splits\",\"typed_splits\",\"hr_zones\"], so a section left out of it is not returned. Weather is served only when asked for (e.g. [\"splits\",\"typed_splits\",\"hr_zones\",\"weather\"], or [\"weather\"] alone for a conditions-only question).","type":"array","items":{"type":"string","enum":["splits","typed_splits","hr_zones","weather"]}}},"required":["activity_ids"]}},{"name":"garmlink_activity_timeseries","title":"Get activity time series","description":"Downsampled sample-by-sample series for an activity. The field names are the FIT ones, and `pace` is not among them. The series an activity can carry: heart_rate (bpm), enhanced_speed/speed (m/s, from which pace follows), enhanced_altitude/altitude (m), power (W), cadence (rpm, or steps per minute per leg when running), temperature (°C), distance (m, cumulative), position_lat/position_long (degrees — the worker converts Garmin's semicircles before storing), plus running dynamics (vertical_oscillation, vertical_ratio, stance_time, stance_time_percent, step_length) and respiration_rate. Buckets to <= `points` samples with per-bucket averages, and always reports the true global min/max/avg per field. Full 1 Hz data lives in the raw FIT; this is LLM-sized.","domain":"activities","annotations":{"title":"Get activity time series","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"activity_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"The garmin_activity_id."},"metrics":{"description":"The fields to return, e.g. ['heart_rate','power']. All fields when omitted.","type":"array","items":{"type":"string"}},"points":{"default":200,"description":"Target number of downsampled points (<=1000).","type":"integer","minimum":10,"maximum":1000}},"required":["activity_id"]}},{"name":"garmlink_stats_summary","title":"Aggregate activity stats","description":"Aggregated training volume over a date range, grouped by sport, month or ISO week: activity count, total distance (km), duration (h), calories and average HR per bucket.","domain":"activities","annotations":{"title":"Aggregate activity stats","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"description":"ISO date lower bound (inclusive).","type":"string"},"to":{"description":"ISO date upper bound (inclusive). A date-only bound covers the whole day.","type":"string"},"group_by":{"default":"sport","description":"Bucketing dimension.","type":"string","enum":["sport","month","week"]}}}},{"name":"garmlink_exercise_sets_get","title":"Get strength sets","description":"The SETS of a strength session: for each one, the movement performed, the repetitions, the load, the duration and which side — the part of a weights session that makes it a training session at all. Without it a squat workout and a walk of the same length are the same three numbers (duration, heart rate, calories), which is why 'am I progressing on squats' could not be answered before. Returns null for an activity that is not set-based, which is most of them — that null means 'not a strength session', never 'the session was empty'. Activity ids come from garmlink_activities_list.","domain":"activities","annotations":{"title":"Get strength sets","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"activity_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Garmin activity id, from garmlink_activities_list."}},"required":["activity_id"]}},{"name":"garmlink_session_analysis","title":"Analyse one session (derived facts)","description":"The derived facts for one activity, computed server-side: pace in the sport's own unit (per km, per 100 m, per 500 m, km/h), the session's detected structure (continuous vs an interval set, from the watch's own typed splits when it recorded them), rest time hiding between elapsed and moving duration, first-half vs second-half pace and heart-rate drift, time-in-zone shares, running mechanics (cadence, ground contact, stride, vertical ratio) start-to-finish, swim length statistics with misdetected lengths flagged, and a comparison against the athlete's most recent comparable session of the SAME sport at a similar distance. The numbers are computed rather than estimated; garmlink_activity_get returns the underlying raw summary, splits and HR zones.","domain":"activities","annotations":{"title":"Analyse one session (derived facts)","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"activity_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"The Garmin activity id to analyse."}},"required":["activity_id"]}},{"name":"garmlink_activity_gpx","title":"Export an activity as GPX","description":"A downloadable GPX 1.1 track for ONE activity — the file Strava, Komoot, RideWithGPS and every mapping tool import. Returns a signed download link valid one hour (NOT the file itself: a long ride is megabytes of XML), plus the track's point count, distance and bounding box. The `download_url` field is a plain URL to the file. Indoor sessions have no GPS and come back as `no_track` (an expected outcome, not an error).","domain":"activities","annotations":{"title":"Export an activity as GPX","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"activity_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"The garmin_activity_id from garmlink_activities_list."}},"required":["activity_id"]}},{"name":"garmlink_sleep_get","title":"Get sleep","description":"Daily sleep summaries, newest first — one compact object per night: total_min and per-stage minutes (deep_min/light_min/rem_min/awake_min), sleep score, skin_temp_deviation_c (deviation from the wearer's OWN calibrated baseline — the earliest illness/overreaching signal here), restless_moments, body_battery_change (what the night gave back), breathing_disruptions per hour, hrv_status, lowest_spo2/avg_sleep_spo2, plus overnight avg_spo2, avg_respiration, resting_hr and overnight_hrv when measured. Covers sleep quality, duration and recovery trends. Hollow (unmeasured) nights are omitted.","domain":"health","annotations":{"title":"Get sleep","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"description":"ISO date lower bound (YYYY-MM-DD), inclusive. When omitted, the most recent days are returned. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"to":{"description":"ISO date upper bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"limit":{"default":60,"description":"Max days returned, newest first (default 60).","type":"integer","minimum":1,"maximum":400}}}},{"name":"garmlink_hrv_get","title":"Get HRV","description":"Daily heart-rate-variability summaries, newest first: last_night_avg (overnight rMSSD, ms), weekly_avg, last_night_5min_high, HRV status (BALANCED/UNBALANCED/LOW/…) AND the wearer's personal baseline band (baseline_low/baseline_high) — the value is meaningful against that band, not against a population average: 58 ms depends on this person's balanced range. Covers autonomic recovery and readiness trends. The raw per-reading series is in garmlink_daily_metric_get(family:'hrv', full:true).","domain":"health","annotations":{"title":"Get HRV","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"description":"ISO date lower bound (YYYY-MM-DD), inclusive. When omitted, the most recent days are returned. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"to":{"description":"ISO date upper bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"limit":{"default":60,"description":"Max days returned, newest first (default 60).","type":"integer","minimum":1,"maximum":400}}}},{"name":"garmlink_stress_get","title":"Get stress","description":"Daily all-day stress summaries, newest first: avg and max stress level (0-100). Shows how stress load evolves across days. The time-in-zone breakdown (rest_min/low_stress_min/medium_stress_min/high_stress_min/activity_stress_min) is not part of this family; those durations are on the day rollup, garmlink_daily_summary_get. The per-minute series is in garmlink_daily_metric_get(family:'stress', full:true).","domain":"health","annotations":{"title":"Get stress","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"description":"ISO date lower bound (YYYY-MM-DD), inclusive. When omitted, the most recent days are returned. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"to":{"description":"ISO date upper bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"limit":{"default":60,"description":"Max days returned, newest first (default 60).","type":"integer","minimum":1,"maximum":400}}}},{"name":"garmlink_body_battery_get","title":"Get Body Battery","description":"Daily Body Battery summaries, newest first: charged and drained totals (energy points gained resting/sleeping vs spent) for the day. Relates energy reserves to sleep, stress and activity. This family is a list of events, so it carries neither the day's levels nor the curve. The day's high, low, at-wake and during-sleep values are on garmlink_daily_summary_get (bb_highest/bb_lowest/bb_at_wake/bb_during_sleep); the intraday curve is in garmlink_daily_metric_get(family:'stress', full:true) — Garmin ships bodyBatteryValuesArray inside the stress record, not this one.","domain":"health","annotations":{"title":"Get Body Battery","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"description":"ISO date lower bound (YYYY-MM-DD), inclusive. When omitted, the most recent days are returned. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"to":{"description":"ISO date upper bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"limit":{"default":60,"description":"Max days returned, newest first (default 60).","type":"integer","minimum":1,"maximum":400}}}},{"name":"garmlink_steps_get","title":"Get steps","description":"Daily step totals, newest first: total steps walked that day. Tracks daily movement. Distance, floors and the step goal for the day are on garmlink_daily_summary_get (step_goal) — the raw steps payload is 15-minute buckets and carries no goal. Those buckets are in garmlink_daily_metric_get(family:'steps', full:true).","domain":"health","annotations":{"title":"Get steps","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"description":"ISO date lower bound (YYYY-MM-DD), inclusive. When omitted, the most recent days are returned. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"to":{"description":"ISO date upper bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"limit":{"default":60,"description":"Max days returned, newest first (default 60).","type":"integer","minimum":1,"maximum":400}}}},{"name":"garmlink_heart_rate_get","title":"Get heart rate","description":"Daily heart-rate summaries, newest first: resting, min, max HR (bpm) and resting_avg_7d — resting_avg_7d is the seven-day average, steadier than a single night's value. Tracks resting-HR trends and daily cardiac load. The intraday HR series is in garmlink_daily_metric_get(family:'heart_rate', full:true).","domain":"health","annotations":{"title":"Get heart rate","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"description":"ISO date lower bound (YYYY-MM-DD), inclusive. When omitted, the most recent days are returned. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"to":{"description":"ISO date upper bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"limit":{"default":60,"description":"Max days returned, newest first (default 60).","type":"integer","minimum":1,"maximum":400}}}},{"name":"garmlink_respiration_get","title":"Get respiration","description":"Daily respiration summaries, newest first: avg_waking and avg_sleep (they are different measurements — the sleeping rate is the recovery signal), plus min and max breaths per minute, and `avg` for continuity. Covers breathing-rate trends and recovery.","domain":"health","annotations":{"title":"Get respiration","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"description":"ISO date lower bound (YYYY-MM-DD), inclusive. When omitted, the most recent days are returned. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"to":{"description":"ISO date upper bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"limit":{"default":60,"description":"Max days returned, newest first (default 60).","type":"integer","minimum":1,"maximum":400}}}},{"name":"garmlink_spo2_get","title":"Get SpO2","description":"Daily pulse-ox (SpO2) summaries, newest first: avg_sleep (the clinically interesting one — the all-day average is diluted by waking readings), low, latest, avg_7d and avg. Covers altitude acclimation and overnight oxygen trends.","domain":"health","annotations":{"title":"Get SpO2","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"description":"ISO date lower bound (YYYY-MM-DD), inclusive. When omitted, the most recent days are returned. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"to":{"description":"ISO date upper bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"limit":{"default":60,"description":"Max days returned, newest first (default 60).","type":"integer","minimum":1,"maximum":400}}}},{"name":"garmlink_floors_get","title":"Get floors climbed","description":"Daily floors summaries, newest first: floors ascended and descended that day. Tracks vertical movement.","domain":"health","annotations":{"title":"Get floors climbed","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"description":"ISO date lower bound (YYYY-MM-DD), inclusive. When omitted, the most recent days are returned. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"to":{"description":"ISO date upper bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"limit":{"default":60,"description":"Max days returned, newest first (default 60).","type":"integer","minimum":1,"maximum":400}}}},{"name":"garmlink_intensity_minutes_get","title":"Get intensity minutes","description":"Daily intensity-minutes summaries, newest first: the day's moderate_min and vigorous_min, the running weekly_total and weekly_moderate/weekly_vigorous against the week_goal, and week_goal_met_on — the day Garmin recorded the weekly target as reached, or absent if it was not. Shows adherence to activity-intensity guidelines.","domain":"health","annotations":{"title":"Get intensity minutes","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"description":"ISO date lower bound (YYYY-MM-DD), inclusive. When omitted, the most recent days are returned. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"to":{"description":"ISO date upper bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"limit":{"default":60,"description":"Max days returned, newest first (default 60).","type":"integer","minimum":1,"maximum":400}}}},{"name":"garmlink_hydration_get","title":"Get hydration","description":"Daily hydration records, newest first: fluid intake versus goal and sweat-loss estimates (ml). Tracks hydration habits.","domain":"health","annotations":{"title":"Get hydration","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"description":"ISO date lower bound (YYYY-MM-DD), inclusive. When omitted, the most recent days are returned. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"to":{"description":"ISO date upper bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"limit":{"default":60,"description":"Max days returned, newest first (default 60).","type":"integer","minimum":1,"maximum":400}}}},{"name":"garmlink_blood_pressure_get","title":"Get blood pressure","description":"Daily blood-pressure records, newest first: systolic/diastolic readings and pulse from Garmin Index BPM or manual entries. Tracks blood-pressure trends.","domain":"health","annotations":{"title":"Get blood pressure","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"description":"ISO date lower bound (YYYY-MM-DD), inclusive. When omitted, the most recent days are returned. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"to":{"description":"ISO date upper bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"limit":{"default":60,"description":"Max days returned, newest first (default 60).","type":"integer","minimum":1,"maximum":400}}}},{"name":"garmlink_daily_summary_get","title":"Get daily summary","description":"The single-glance all-day rollup, newest first — the richest daily object garmlink serves. Steps, calories, distance_m, active_min, floors, PLUS the goals Garmin set for this wearer (step_goal/floors_goal/intensity_minutes_goal — the only way to answer whether a target was hit), where the day's stress went (rest_min/low_stress_min/medium_stress_min/high_stress_min/activity_stress_min, stress_avg/max/qualifier), the body battery as a day rather than a net (bb_charged/bb_drained/bb_highest/bb_lowest/bb_at_wake/bb_during_sleep), the calorie split (bmr_calories/active_calories/consumed_calories), the time budget (sleeping_min, sedentary_min, and highly_active_min which is a subset of active_min, not a sibling of it), resting_hr with resting_hr_avg_7d, abnormal_hr_alerts (the watch flagged an abnormally high resting heart rate), avg_altitude_m, and measured_from/measured_to — the window the watch was actually worn, without which two days with identical averages are not comparable. Covers day-level overviews and multi-metric daily trends; each specific family (garmlink_sleep_get, garmlink_stress_get, …) carries its own detail.","domain":"health","annotations":{"title":"Get daily summary","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"description":"ISO date lower bound (YYYY-MM-DD), inclusive. When omitted, the most recent days are returned. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"to":{"description":"ISO date upper bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"limit":{"default":60,"description":"Max days returned, newest first (default 60).","type":"integer","minimum":1,"maximum":400}}}},{"name":"garmlink_daily_metric_get","title":"Get any daily metric","description":"Generic escape hatch: any Garmin daily family by name over a date window, newest first. Returns the same compact per-day summary as the dedicated getters by default; full:true returns the RAW record (all intraday arrays), which is large. Every family except all_day_events has a dedicated getter (garmlink_sleep_get, garmlink_stress_get, …); this tool is the only one serving all_day_events, and serves the raw record of any family. Returns an error object listing valid families if the name is unknown.","domain":"health","annotations":{"title":"Get any daily metric","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"family":{"type":"string","description":"A daily family, one of: sleep,hrv,stress,body_battery,steps,heart_rate,training_readiness,user_summary,respiration,spo2,floors,intensity_minutes,hydration,blood_pressure,all_day_events,nutrition,menstrual"},"from":{"description":"ISO lower bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"to":{"description":"ISO upper bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"limit":{"default":60,"description":"Max days, newest first.","type":"integer","minimum":1,"maximum":400},"full":{"default":false,"description":"false (default) = compact per-day summary; true = raw Garmin record with all intraday arrays (large).","type":"boolean"}},"required":["family"]}},{"name":"garmlink_weekly_totals_get","title":"Get weekly totals","description":"A year of WEEK-level totals in one payload — steps (total and daily average, distance, days the watch was worn), stress, and intensity minutes against the weekly goal. Garmin computes these week buckets itself, and they cover questions like 'how has this year gone' or 'which week was my biggest'; the same totals summed from daily rows take a long range and count partially-worn days as low ones. Single days and short spans are covered by the daily tools (garmlink_steps_get, garmlink_stress_get, garmlink_intensity_minutes_get). A series Garmin had nothing for is absent from the payload rather than present and empty.","domain":"health","annotations":{"title":"Get weekly totals","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":4,"description":"Max weekly-rollup snapshots, newest first (each carries a year of weeks).","type":"integer","minimum":1,"maximum":60}}}},{"name":"garmlink_training_status_get","title":"Training status history","description":"Garmin Training Status snapshots over time (productive, maintaining, peaking, overreaching, detraining, recovery, unproductive…), with acute/chronic load balance and load focus. Indicates whether training is productive or recovery is needed.","domain":"training","annotations":{"title":"Training status history","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":30,"description":"Max snapshots, newest first","type":"integer","minimum":1,"maximum":200}}}},{"name":"garmlink_vo2max_history","title":"VO2max history","description":"History of Garmin max-metrics snapshots — chiefly VO2max (running and cycling) and related fitness estimates. Shows cardiovascular fitness trends over weeks and months.","domain":"training","annotations":{"title":"VO2max history","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":30,"description":"Max snapshots, newest first","type":"integer","minimum":1,"maximum":200}}}},{"name":"garmlink_fitness_age_get","title":"Fitness age history","description":"Garmin Fitness Age snapshots and the contributing factors Garmin exposes (VO2max, resting HR, activity intensity, body composition where available). Shows how the estimated fitness age is trending.","domain":"training","annotations":{"title":"Fitness age history","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":30,"description":"Max snapshots, newest first","type":"integer","minimum":1,"maximum":200}}}},{"name":"garmlink_race_predictions_get","title":"Race time predictions","description":"Garmin's predicted race finish times (5K, 10K, half-marathon, marathon) captured over time. Shows current running performance potential and its trajectory.","domain":"training","annotations":{"title":"Race time predictions","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":30,"description":"Max snapshots, newest first","type":"integer","minimum":1,"maximum":200}}}},{"name":"garmlink_endurance_score_get","title":"Endurance score history","description":"Garmin Endurance Score snapshots — the composite measure of the user's ability to sustain effort over long durations, with its level/category. Shows endurance development over time.","domain":"training","annotations":{"title":"Endurance score history","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":30,"description":"Max snapshots, newest first","type":"integer","minimum":1,"maximum":200}}}},{"name":"garmlink_hill_score_get","title":"Hill score history","description":"Garmin Hill Score snapshots — the measure of climbing strength and endurance on uphill efforts, with its category. Shows how hill/climbing ability is progressing.","domain":"training","annotations":{"title":"Hill score history","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":30,"description":"Max snapshots, newest first","type":"integer","minimum":1,"maximum":200}}}},{"name":"garmlink_personal_records_get","title":"Personal records","description":"Garmin personal records snapshots (fastest 1K/5K/10K, longest run/ride, most ascent, best power, etc.). Gives all-time bests and when they were set.","domain":"training","annotations":{"title":"Personal records","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":30,"description":"Max snapshots, newest first","type":"integer","minimum":1,"maximum":200}}}},{"name":"garmlink_body_composition_get","title":"Body composition history","description":"Garmin body-composition snapshots (weight, BMI, body fat %, muscle mass, bone mass, body water, etc.), typically from a connected smart scale. Shows weight and composition trends over time.","domain":"training","annotations":{"title":"Body composition history","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":30,"description":"Max snapshots, newest first","type":"integer","minimum":1,"maximum":200}}}},{"name":"garmlink_zones_get","title":"Heart-rate & power zones","description":"The user's currently configured training zones: heart-rate zones, power zones and cycling FTP (each the latest snapshot). Gives the reference for zone-based effort in activities and target zones.","domain":"training","annotations":{"title":"Heart-rate & power zones","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}},{"name":"garmlink_readiness_get","title":"Training readiness","description":"Daily Garmin Training Readiness, newest first: score (0–100), level, Garmin's own feedback phrase — and the six factors that produce the score, each with its percentage contribution and Garmin's plain-language verdict: sleep score, recovery time (plus recovery_trend), HRV, sleep history, stress history, and acute load / ACWR. A readiness of 12 is not actionable on its own; `recovery_pct: 5, acwr_pct: 20` says exactly what pulled it down. Also measured_at and valid_sleep (false = the score was computed without a usable night, which is why a reading can look wrong). Shows whether today suits a hard session or recovery, and why.","domain":"training","annotations":{"title":"Training readiness","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"description":"ISO lower bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"to":{"description":"ISO upper bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"limit":{"default":14,"description":"Max days, newest first (default 14).","type":"integer","minimum":1,"maximum":90}}}},{"name":"garmlink_lactate_threshold_get","title":"Get lactate threshold","description":"The runner's current lactate threshold: the heart rate and the pace at which lactate starts accumulating faster than the body clears it — i.e. the ceiling above which an effort stops being sustainable. It is the number tempo and threshold sessions are prescribed from, and the one that moves when a training block works. Garmin revises it after a hard effort rather than every day, so this is a standing estimate with its measurement date, not a daily series. Covers threshold pace and heart rate, tempo-run pacing and threshold changes over time.","domain":"training","annotations":{"title":"Get lactate threshold","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":30,"description":"Max snapshots, newest first","type":"integer","minimum":1,"maximum":200}}}},{"name":"garmlink_running_tolerance_get","title":"Get running tolerance","description":"Weekly running tolerance: the running load the body currently absorbs, against the load actually run, over the past year. It answers the question training status cannot — not 'how fit am I' but 'how much running can I add right now without breaking'. A week run far above tolerance is where injuries are booked. Covers mileage ramp-up, whether a jump in volume is safe, and accumulated running fatigue.","domain":"training","annotations":{"title":"Get running tolerance","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":30,"description":"Max snapshots, newest first","type":"integer","minimum":1,"maximum":200}}}},{"name":"garmlink_weigh_ins_get","title":"Get weigh-ins","description":"Individual weigh-ins over the stored window, each with its date, its source device and every metric the scale measured — weight, body fat, body water, muscle mass, bone mass, BMI. This is the reading-by-reading record; garmlink_body_composition_get carries Garmin's summary of the same window. Covers the weight on a given day, how weight has moved, and one odd reading versus a trend.","domain":"training","annotations":{"title":"Get weigh-ins","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":30,"description":"Max snapshots, newest first","type":"integer","minimum":1,"maximum":200}}}},{"name":"garmlink_gear_list","title":"List gear","description":"The user's Garmin gear snapshots (shoes, bikes and other tracked equipment) with accumulated mileage/usage. Most recent snapshot first. Covers how far a pair of shoes or a bike has been ridden/run, and when gear was retired.","domain":"profile","annotations":{"title":"List gear","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":5,"description":"Max snapshots","type":"integer","minimum":1,"maximum":50}}}},{"name":"garmlink_devices_list","title":"List devices","description":"The user's registered Garmin devices (e.g. Fenix 8, HRM straps, bike computers) as captured snapshots, most recent first. Covers which watch/sensors are paired, firmware/model details, and which device recorded the data.","domain":"profile","annotations":{"title":"List devices","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":5,"description":"Max snapshots","type":"integer","minimum":1,"maximum":50}}}},{"name":"garmlink_profile_get","title":"Get user profile","description":"The user's latest Garmin profile snapshot: display name, personal details, physiological settings and preferences. Returns the single most recent snapshot.","domain":"profile","annotations":{"title":"Get user profile","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}},{"name":"garmlink_solar_get","title":"Get solar intake","description":"Solar charging for the watches that have a panel: the daily solar input over the stored window, keyed by device and carrying each watch's display name — a household with two Garmins would otherwise read as one. Absent entirely for a watch without a panel, which is not an error. Covers solar charging, battery autonomy and the sun a trip gave.","domain":"profile","annotations":{"title":"Get solar intake","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":4,"description":"Max solar snapshots, newest first (each carries several weeks of days).","type":"integer","minimum":1,"maximum":60}}}},{"name":"garmlink_sync_status","title":"Sync status","description":"Garmin connection state plus last successful sync time and the most recent sync runs (status, scope, timing, counts). Shows whether the account is connected, when it last synced, and whether a sync is currently running or recently failed.","domain":"sync","annotations":{"title":"Sync status","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}},{"name":"garmlink_sync_refresh","title":"Trigger a Garmin sync","description":"Triggers an on-demand sync that fetches the freshest data from the user's Garmin account (it contacts Garmin; the only tool that does). Rate-limited to at most once per 15 minutes; if a sync ran recently it returns status:rate_limited with retry_after_s. Non-destructive — it only fetches and appends new data, never deletes anything. Returns {status:'started'} on success; {status:'queued', queued:true, resume_at, message} when the sync service has no free slot or Garmin asked it to pause: the request is kept and starts by itself as soon as a slot frees up (usually within a few minutes), or at resume_at (ISO) during a pause, and is not counted against the limit; {status:'already_running'} when a sync is already in progress. On success it also returns whatever the worker echoed back — sync_run_id is present only when the worker supplies it; garmlink_sync_status reports the sync's progress either way. Requires a connected account; returns {error:'not_connected'} otherwise. On the demo account there is nothing to fetch: it returns {status:'demo', message} and starts no sync. When the sync service cannot be reached it returns {error:'worker_unavailable', detail}.","domain":"sync","annotations":{"title":"Trigger a Garmin sync","readOnlyHint":false,"destructiveHint":false,"openWorldHint":true},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}},{"name":"garmlink_golf_summary_get","title":"Get golf summaries","description":"The user's stored golf-round summaries (scores, handicap, course stats), most recent first. Covers golf performance and rounds played.","domain":"peripheral","annotations":{"title":"Get golf summaries","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":30,"description":"Max entries","type":"integer","minimum":1,"maximum":60}}}},{"name":"garmlink_badges_get","title":"Get earned badges","description":"The Garmin badges the user has earned (challenges, milestones, streaks), most recent first. Covers achievements, badges and Garmin challenges.","domain":"peripheral","annotations":{"title":"Get earned badges","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":30,"description":"Max entries","type":"integer","minimum":1,"maximum":60}}}},{"name":"garmlink_goals_get","title":"Get user goals","description":"The user's Garmin goals (step targets, distance/activity goals and their progress), most recent first. Covers the goals set and how close they are to being reached.","domain":"peripheral","annotations":{"title":"Get user goals","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":30,"description":"Max entries","type":"integer","minimum":1,"maximum":60}}}},{"name":"garmlink_nutrition_get","title":"Get daily nutrition","description":"Daily nutrition logs (calories in, macros, water/food entries) per day, newest first, optionally bounded by a date range. Covers food intake, calories consumed and macros over time.","domain":"peripheral","annotations":{"title":"Get daily nutrition","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"description":"ISO date lower bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"to":{"description":"ISO date upper bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"limit":{"default":60,"description":"Max days","type":"integer","minimum":1,"maximum":400}}}},{"name":"garmlink_menstrual_get","title":"Get menstrual cycle data","description":"Daily menstrual-cycle tracking (cycle phase, day, logged symptoms) per day, newest first, optionally bounded by a date range. Covers cycle tracking.","domain":"peripheral","annotations":{"title":"Get menstrual cycle data","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"description":"ISO date lower bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"to":{"description":"ISO date upper bound (YYYY-MM-DD), inclusive. A time part is ignored: the calendar day written is used, with no timezone conversion.","type":"string"},"limit":{"default":60,"description":"Max days","type":"integer","minimum":1,"maximum":400}}}},{"name":"garmlink_snapshot_get","title":"Get any snapshot by kind","description":"Any stored snapshot by its kind, so every synced snapshot type is reachable, even those without a dedicated tool. Returns the most recent snapshots for that kind first. Catch-all for snapshot kinds that have no dedicated tool.","domain":"peripheral","annotations":{"title":"Get any snapshot by kind","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"kind":{"type":"string","description":"A snapshot kind, e.g. training_status, max_metrics, race_predictions, gear, devices, badges, goals, golf_summary, endurance_score, hill_score, personal_records, body_composition, hr_zones, power_zones, cycling_ftp, fitness_age, profile"},"limit":{"default":10,"description":"Max snapshots","type":"integer","minimum":1,"maximum":200}},"required":["kind"]}}],"prompts":[{"name":"garmlink_week_review","title":"Review my training week","description":"Summarize the last 7 days of training: total load per sport, standout sessions, and how sleep, HRV and training status say the body is coping.","body":"Produce a coach-style review of the athlete's last training week. Call the tools in this order and reason over the combined results:\n\n1. garmlink_stats_summary with group_by=\"sport\" over the last 7 days (from = 7 days ago, to = today) to get per-sport volume, distance, duration and load.\n2. garmlink_activities_list for the same 7-day window to enumerate every session (type, date, distance, duration, average HR).\n3. garmlink_sleep_get for the last 7 days to gauge nightly sleep duration and quality.\n4. garmlink_hrv_get for the last 7 days to read the overnight HRV trend (rising, stable, or suppressed).\n5. garmlink_training_status_get to capture the current training status, acute load and load balance.\n\nThen synthesize: total training load and how it splits across sports, the 1-2 standout/hardest sessions of the week, and whether recovery signals (sleep + HRV + training status) suggest the athlete absorbed the load or is dipping into fatigue. End with one concrete recommendation for the coming days.","tools":["garmlink_stats_summary","garmlink_activities_list","garmlink_sleep_get","garmlink_hrv_get","garmlink_training_status_get"]},{"name":"garmlink_race_readiness","title":"Race readiness check","description":"Assess how ready the athlete is for a target race by combining race-time predictions, training readiness, training status, VO2max trajectory and recent HRV.","body":"Evaluate the athlete's readiness for an upcoming target race. Ask the user for the race distance/date if it is not already known, then call the tools in this order:\n\n1. garmlink_race_predictions_get to retrieve Garmin's predicted finish times (5K, 10K, half, marathon) and compare them against the athlete's target.\n2. garmlink_readiness_get to read today's training readiness score and its contributing factors (sleep, recovery time, HRV status, acute load).\n3. garmlink_training_status_get to confirm the athlete is productive/peaking rather than overreaching or detraining.\n4. garmlink_vo2max_history to check whether VO2max is trending up, flat or down over recent weeks.\n5. garmlink_hrv_get for the last 1-2 weeks to confirm autonomic recovery is stable heading into the race.\n\nThen synthesize a readiness verdict versus the target race: is the current fitness (VO2max + predictions) enough to hit the goal, and is the athlete recovered enough (readiness + status + HRV) to express it. Flag any red flags (falling VO2max, suppressed HRV, unproductive status) and give a taper/pacing recommendation.","tools":["garmlink_race_predictions_get","garmlink_readiness_get","garmlink_training_status_get","garmlink_vo2max_history","garmlink_hrv_get"]},{"name":"garmlink_sleep_recovery","title":"Sleep & recovery report","description":"Build a two-week recovery report from sleep, HRV, Body Battery and stress data to reveal whether the athlete is trending toward recovery or accumulating fatigue.","body":"Produce a recovery report covering the last 2 weeks. Call the tools in this order over a 14-day window (from = 14 days ago, to = today):\n\n1. garmlink_sleep_get to gather nightly sleep duration, sleep stages (deep/light/REM) and sleep scores.\n2. garmlink_hrv_get to read the overnight HRV trend and whether it sits inside the athlete's balanced range.\n3. garmlink_body_battery_get to track daily Body Battery drain and overnight recharge.\n4. garmlink_stress_get to see average and peak daytime stress levels.\n\nThen synthesize the recovery trend: are sleep, HRV, Body Battery recharge and stress moving in a healthy direction or degrading? Call out the best and worst nights, any multi-day patterns (e.g. poor sleep + low HRV + high stress clustering), and give concrete recovery guidance (sleep hygiene, load reduction, active recovery) for the week ahead.","tools":["garmlink_sleep_get","garmlink_hrv_get","garmlink_body_battery_get","garmlink_stress_get"]},{"name":"garmlink_session_deep_dive","title":"Analyse one session","description":"Deep-dive a single session of any sport: pull its splits and timeseries (HR, speed, power, altitude) to analyse pacing, cardiac drift and split-by-split execution.","body":"Perform a detailed analysis of one specific session — run, ride, swim, row or anything else the athlete recorded. Call the tools in this order:\n\n1. garmlink_session_analysis with the activity id. It returns the DERIVED facts in one round: pace in the sport's own unit, the detected structure (continuous or a set, from the watch's own typed splits when it recorded them), the rest hiding between elapsed and moving time, half-to-half pace and heart-rate drift, time in zone, running mechanics start-to-finish, swim lengths with misdetections flagged, and the athlete's most recent comparable session of the same sport. Trust its arithmetic over your own — it is computed, not estimated.\n1b. If you were not given an id, garmlink_activities_list filtered to the sport to find the session first (ask the user which one if it is ambiguous).\n2. garmlink_activity_get with that activity id ONLY when you need something the derived facts did not carry — a lap-by-lap table to print, the weather, a field specific to the sport. Whatever you print, read the sport's OWN units: pace per km for running, time per 100 m for swimming, km/h and power for cycling, time per 500 m for rowing.\n3. garmlink_activity_timeseries with that id and the metrics the sport records — heart_rate and altitude for everyone, speed for anything that moves over ground, power for cycling, cadence where it exists.\n4. garmlink_zones_get to read the athlete's heart-rate zones, so time-in-zone is judged against THEIR thresholds rather than a textbook's.\n5. garmlink_stats_summary to place this session against the athlete's recent averages for the same sport.\n\nThen synthesize: pacing consistency (went out too fast, negative-split, or faded), cardiac drift (rising HR at steady output = fatigue or heat), output against the altitude profile (climbs vs descents), the split-by-split execution, and where the effort actually sat in the zones. Close with 2-3 actionable takeaways for the next session of this type.","tools":["garmlink_session_analysis","garmlink_activities_list","garmlink_activity_get","garmlink_activity_timeseries","garmlink_zones_get","garmlink_stats_summary"]},{"name":"garmlink_health_overview","title":"How is my health trending?","description":"A month of the everyday health signals — resting heart rate, HRV, SpO2, respiration, stress and steps — read together for the drifts no single day shows.","body":"Read the athlete's everyday health signals over the last 30 days (from = 30 days ago, to = today) and report what is DRIFTING, which no single day can show. Call:\n\n1. garmlink_heart_rate_get for the resting heart-rate series — the single most telling everyday marker.\n2. garmlink_hrv_get for overnight HRV and its balanced range.\n3. garmlink_spo2_get and garmlink_respiration_get for overnight oxygen saturation and breathing rate.\n4. garmlink_stress_get for daytime stress, and garmlink_steps_get with garmlink_daily_summary_get for everyday movement.\n\nThen synthesize the DIRECTION of each signal over the month, not its average: what is rising, falling or steady, and which ones moved together (a resting HR climbing while HRV falls is one story, not two). Name the days that stand out and say plainly which are explained by training and which are not.\n\nTwo rules you must not break. Report gaps as gaps: days with no reading mean the watch was not worn, never that the value was zero, and a trend drawn over a fortnight with five missing nights deserves to be called shaky. And stay descriptive — you are reading consumer wearable data, so describe what changed and suggest what to watch or discuss with a clinician; never diagnose, and never interpret a signal as evidence of a condition.","tools":["garmlink_heart_rate_get","garmlink_hrv_get","garmlink_spo2_get","garmlink_respiration_get","garmlink_stress_get","garmlink_steps_get","garmlink_daily_summary_get"]},{"name":"garmlink_progress_review","title":"Am I getting fitter?","description":"The long view: VO2max trajectory, race predictions, fitness age, endurance and hill scores and personal records, read over months rather than weeks.","body":"Answer the only question that matters over months: is this athlete getting fitter? Call:\n\n1. garmlink_vo2max_history for the VO2max trajectory — the backbone of the answer.\n2. garmlink_race_predictions_get to see whether predicted finish times are improving alongside it.\n3. garmlink_fitness_age_get, garmlink_endurance_score_get and garmlink_hill_score_get for Garmin's own composite verdicts.\n4. garmlink_personal_records_get for what the athlete has actually achieved, not only what a model predicts.\n5. garmlink_stats_summary over the same span to relate any change to the training volume that produced it.\n\nThen synthesize a verdict with a TIMESCALE attached: improving, plateaued or declining, over what period, and by how much. Tie it to the volume: a flat VO2max on rising volume says something different from a flat one on falling volume. Say when a change is too small to mean anything — these scores move by a point on noise — and finish with the one lever most likely to move the needle next.","tools":["garmlink_vo2max_history","garmlink_race_predictions_get","garmlink_fitness_age_get","garmlink_endurance_score_get","garmlink_hill_score_get","garmlink_personal_records_get","garmlink_stats_summary"]}],"resources":[{"uri":"garmlink://profile","name":"Garmin profile","description":"The user's Garmin profile settings snapshot."},{"uri":"garmlink://gear","name":"Gear","description":"The user's gear (shoes/bikes) with mileage."},{"uri":"garmlink://connection-status","name":"Connection status","description":"Garmin connection + sync status."},{"uri":"garmlink://skill","name":"Using garmlink (Garmin data over MCP)","description":"Copy-pasteable usage skill for AI assistants: which tool for what, rate limits, interpretation guidance. Read this once per session for best results."}],"skill_md":"# Using garmlink — Garmin data over MCP\n\nYou have access to garmlink, an MCP connector exposing this user's real Garmin\nwatch data: activities, sleep, HRV, stress, body battery, training status and\nmore. Answer training/recovery questions from THIS data — never from guesses.\n\n## Ground rules\n\n- All tools are read-only except `garmlink_sync_refresh` (rate-limited to one\n  refresh per 15 minutes — call it at most once, only when data looks stale).\n  Follow its progress with `garmlink_sync_status`: the `sync_run_id` it\n  returns is not always present.\n- FEW CALLS BEAT MANY. `garmlink_activities_list` answers most workout\n  questions alone (its rows carry a `brief` of sport metrics, and `synced_at`\n  says how fresh the data is — no separate sync-status call). Need more, for\n  several activities? `garmlink_activities_get` with ALL the ids in ONE call —\n  never loop `garmlink_activity_get`.\n- Call `garmlink_sync_status` first whenever data seems missing, empty or stale,\n  or you need the history depth. A young watch has a short history — absence of old data is\n  not missing data.\n- Default tool responses are compact per-day summaries. Only pass `full:true`\n  (on `garmlink_daily_metric_get`) for a single family over a NARROW window —\n  raw records are large.\n- Dates are ISO `YYYY-MM-DD`. Most daily tools accept `from`/`to`/`limit`\n  (default 60 days). Ask for what you need, not the maximum.\n\n## Which tool for what\n\n- Workouts: `garmlink_activities_list` first — comparisons usually end there\n  (`brief`: pace/speed, max HR, SWOLF & strokes, cadence, power). Splits and\n  HR zones for several sessions: `garmlink_activities_get` (batch, one call;\n  weather is opt-in via `include`). One session's intra-workout curves:\n  `garmlink_activity_timeseries` (pace/HR/power over time).\n  Aggregates: `garmlink_stats_summary` (by sport/month/week). For a baseline\n  of one sport, filter with `exact_type`: `type` matches loosely (\"running\"\n  also returns a walk named \"Running errands\").\n- Sleep & recovery: `garmlink_sleep_get` (stages, score, overnight HRV),\n  `garmlink_hrv_get`, `garmlink_body_battery_get`, `garmlink_stress_get`,\n  `garmlink_readiness_get`.\n- Fitness markers: `garmlink_training_status_get`, `garmlink_vo2max_history`,\n  `garmlink_race_predictions_get`, `garmlink_personal_records_get`.\n- Anything else daily: `garmlink_daily_summary_get` (calories/steps/distance\n  rollup; the place to start for a day-level overview or multi-metric trend, then\n  drill into one family) or `garmlink_daily_metric_get` (any family by name; use\n  the dedicated getter when one exists — this is for `all_day_events` and raw\n  records).\n- One session's analysis: `garmlink_session_analysis` first (pace, structure,\n  drift, same-sport comparison, already computed), `garmlink_activity_get` only\n  for what it does not derive. Route files: `garmlink_activity_gpx` — give the\n  user the `download_url` as a clickable link.\n\n## Interpretation guidance\n\n- Cross-reference before concluding: pair sleep with HRV and body battery before\n  calling the user \"recovered\"; pair training load with readiness before\n  prescribing intensity.\n- Garmin sentinel values: stress -1/-2 means \"not measured\", not zero.\n- Read HRV against the user's own baseline band, never a population average.\n- Cite the numbers you used (dates + values) so the user can verify.\n- Prefer the built-in prompts when they fit: `garmlink_week_review`,\n  `garmlink_race_readiness`, `garmlink_sleep_recovery`, `garmlink_run_deep_dive`.\n"}