Store Garmin Connect credentials encrypted in the OS native vault and log in immediately. Use this when the server reports that credentials are missing or invalid. The password is encrypted at rest and never written to a plain text file.

Report whether Garmin credentials are configured, which source they come from, where the encrypted data is stored and whether the session is authenticated. Never returns the password.

Delete the encrypted credentials and OAuth tokens from secure storage and end the current session. Credentials supplied through the extension settings are not affected and must be cleared there.

Get a list of recent activities from Garmin Connect. Each one is summarised: name, type, date, distance, duration, speed, heart rate, calories, elevation, steps and training effect. Use get_activity_details for one activity in full.

Get detailed information about a specific activity including splits, heart rate zones, and GPS data.

Get daily health metrics including heart rate data and step count for a specific date.

Get a night of sleep: duration, sleep stages, quality score and the nightly summary. The per-minute series behind it (movement, heart rate, stress, body battery, HRV, respiration) are reported as counts only; set includeTimeSeries to inline them, or use the dedicated tool for the one series you need.

Get body composition measurements (weight, BMI, body fat, muscle and bone mass) over a period, plus the average across the period.

List the Garmin devices registered on the account with their id, model, serial and firmware version. Use get_device_settings for the configuration of a single device.

Get user profile information: display name, user name, full name and both account ids. profileId is the one other Garmin data is keyed by (the ownerId on an activity, the userProfilePK on wellness records); id is a separate internal identifier.

Get the training status for a date: status and feedback phrase, VO2 max, fitness trend, acute and chronic training load and the acute/chronic workload ratio.

Get step count for a specific date. Returns the total number of steps recorded.

Get detailed heart rate data for a specific date including resting HR, max HR, and HR zones.

Get daily hydration/water intake data for a specific date.

Get list of scheduled/planned workouts from Garmin Connect.

Get split/lap data for a specific activity including pace, distance, and time for each split.

Get stress for a date on the 0-100 scale (0-25 resting, 26-50 low, 51-75 medium, 76-100 high). Returns average/max/min and the seconds spent in each band; set includeValues to also get the ~460 three-minute samples. The average and maximum are the day figures Garmin itself reports, so they match the Connect app; the minimum and the band seconds are derived from the samples. Use get_all_day_stress for the same day broken down hour by hour.

Get Body Battery energy level data for a date range. Body Battery tracks energy levels (0-100) throughout the day based on sleep, stress, and activity. Shows charged/drained periods and sleep quality impact.

Get Heart Rate Variability (HRV) data for a specific date. HRV measures the variation in time between heartbeats, indicating recovery and stress levels.

Get respiration/breathing rate data for a specific date. Shows breaths per minute throughout the day and during sleep.

Get SpO2 (blood oxygen saturation) data for a specific date. Shows pulse oximetry readings as percentage (typically 95-100% is normal).

Get detailed information about a specific workout by its ID.

Download a workout in FIT format for syncing to a Garmin device.

Create a new structured workout in Garmin Connect. Supports complex interval workouts with warmup, cooldown, and repeat blocks.

Example for interval running workout: { "workoutName": "5x3min Intervals", "sportType": "running", "description": "Interval training", "workoutSegments": [{ "segmentOrder": 1, "sportType": "running", "workoutSteps": [ { "stepOrder": 1, "stepType": "warmup", "endCondition": "time", "endConditionValue": 600 }, { "stepOrder": 2, "stepType": "interval", "endCondition": "time", "endConditionValue": 180, "targetType": "pace" }, { "stepOrder": 3, "stepType": "recovery", "endCondition": "time", "endConditionValue": 120 }, { "stepOrder": 4, "stepType": "cooldown", "endCondition": "time", "endConditionValue": 600 } ] }] }

Update an existing workout (name, description, or structure).

Delete a workout from Garmin Connect.

Schedule an existing workout on a specific date. Returns a workoutScheduleId that can be used to unschedule.

Remove a scheduled workout from the calendar. IMPORTANT: Always unschedule before deleting a workout to avoid ghost entries.

Upload an activity file (FIT, GPX, TCX format) to Garmin Connect.

Create a manual activity entry in Garmin Connect.

Change the name of an existing activity.

Change the type/category of an existing activity.

Delete an activity from Garmin Connect. WARNING: This action cannot be undone.

Download an activity in various formats (FIT, TCX, GPX, KML, CSV).

Get the Garmin device that uploaded data most recently, with its id, name and upload time.

Get settings for a specific Garmin device.

Get the stress of a day hour by hour: average, maximum and stress band for each hour, plus the totals for the day. Use this to see when stress rose or fell; use get_stress_data for the day as a whole, and its includeValues for the individual three-minute samples.

Get the floors climbed and descended on a date. Returns the daily totals; set includeBreakdown to also get the 96 quarter-hour intervals behind them.

Get intensity minutes (moderate and vigorous) for a date, or for a date range when endDate is given, together with the weekly totals and goal.

Get max metrics including VO2 max and related fitness data.

Get training readiness score indicating how prepared your body is for training.

Get endurance score based on recent training load.

Get fitness age estimation based on VO2 max and other metrics.

Get weigh-in records for a date range.

Add a new weigh-in record. Weight and body fat are stored; the water, muscle and bone percentages are accepted but Garmin discards them on a manual entry, keeping them only for measurements a smart scale uploads.

Permanently delete a single weigh-in record, identified by its weigh-in ID (the samplePk from get_weigh_ins or get_body_composition). The measurement cannot be recovered afterwards. Pass date when the weigh-in was back-dated to a day other than the one it was entered on.

Get blood pressure readings for a date range.

Record a blood pressure reading.

Delete a blood pressure reading. Use get_blood_pressure with the /all endpoint to find the version ID.

Get weather conditions during an activity.

Get time spent in each heart rate zone during an activity.

Get exercise sets from a strength training activity.

Get user goals. Without a status every status is queried in turn and the results are merged, each goal carrying the status it was found under.

Get ad-hoc challenges history.

Get available badge challenges.

Get all badges earned by the user, as id, key, name, category, difficulty, points and the date earned. Set includeDetails for the full badge records.

Get all personal records (PRs). Each record carries a typeId identifying its category, its value, the date it was set and, for records set during an activity, that activity.

Get predicted race times for 5K, 10K, half marathon, and marathon based on current fitness.

Get usage statistics for a specific piece of gear. Note: Requires the gear UUID which can be found in Garmin Connect web interface URL.

Link a piece of gear to an activity. Note: Requires the gear UUID which can be found in Garmin Connect web interface URL.

Get aggregated progress summary between two dates.

Get a compact daily summary: steps and goal, calories, distance, floors, intensity minutes, resting/min/max heart rate, stress, body battery and time breakdown. Use get_heart_rate for the full heart rate series.

Get comprehensive user activity summary for a specific date including steps, calories, distance, active minutes, and more.

Get detailed step data chart for a specific date with timestamps.

Get daily step counts for a date range (max 28 days per request, auto-chunked for longer ranges).

Get all activities within a date range, optionally filtered by type. Each one is summarised the same way list_recent_activities summarises them.

Get typed splits for an activity (more detailed than regular splits, useful for bouldering, strength training, etc.).

Get resting heart rate for a specific day.

Get hill score data indicating climbing/vertical performance.

Get all daily events including auto-detected activities that may not have been recorded.

Get Body Battery events for a date (sleep, activities, naps that affected energy levels).

Add hydration/water intake data in milliliters.

Get all badges available to earn, as id, key, name, category, difficulty, points and, where set, the active window and progress. Set includeDetails for the full badge records.

Get badges that are currently in progress (started but not completed).

Get available badge challenges to join.

Get badge challenges that have not been completed yet.

Get virtual challenges that are currently in progress.

Remove/unlink a piece of gear from an activity. Note: Requires the gear UUID from Garmin Connect web interface.

Get activities where a specific piece of gear was used. Note: Requires the gear UUID from Garmin Connect web interface.

Get all available training plans.

Get detailed information about a specific training plan.

Get menstrual cycle data for a specific date.

Get pregnancy tracking summary/snapshot data.

Request reload of data for a specific date (useful for older data that was offloaded by Garmin).

Get all activity types available in Garmin Connect.

Get information about the primary training device and device priorities.

Count the activities in Garmin Connect, over the whole history or over a date range.

Get aggregated fitness statistics between two dates.

Get complete list of all gear/equipment with their UUIDs. This solves the UUID problem - you can now discover all gear without needing to manually find UUIDs in the web interface.

Update existing gear/equipment details.

Delete a piece of gear/equipment. WARNING: This cannot be undone.

Get all available gear/equipment types (e.g., Shoes, Bike, Golf Clubs, Other). Returns type names and primary keys used when creating gear.

Get all available gear brands/makes (e.g., Nike, Adidas, ASICS, Brooks). Returns make names and primary keys.

Get all gear collections. Collections group gear items that are used together (e.g., running kit, bike components).

Get detailed information about a specific gear collection, including the gear items in the collection and associated activity types.

Create a new gear collection to group equipment used together (e.g., running kit, bike components). Requires a name and first use date.

Update an existing gear collection. Can change name, add/remove gear items, or change associated activity types.

Delete a gear collection. WARNING: This cannot be undone. The gear items in the collection will NOT be deleted.

Get all comments on an activity.

Change the privacy of an activity. "subscribers" is what Garmin Connect shows as "connections only". Read the current level from accessControlRuleDTO in get_activity_details before changing it.

Get the monthly training load balance (low aerobic, high aerobic, anaerobic) against its target ranges. This is a snapshot taken on endDate, not an aggregate over the range.

Get acute/chronic workload ratio indicating training balance and injury risk.

Get the performance condition score for a date. Garmin records this per activity rather than daily, so it is usually only available through get_activity_details.

Get movement data during sleep including restless moments.

Get the alarms configured on a Garmin device, with time, repeat days and whether each one is on. Without a deviceId every registered device is reported.

Get saved routes/courses from Garmin Connect.

Compare 2-5 activities side by side: distance, duration, speed, heart rate, calories, elevation, steps and training effect.

Find activities similar to a reference activity by type, distance and duration (within 20% tolerance). Returns the closest matches first, each with its full metrics and a similarity score.

Comprehensive analysis of training trends, volume, and patterns over a date range.