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. Returns activity summaries including name, type, distance, duration, and date.

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 detailed sleep information including duration, sleep stages, and quality score.

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 including display name and account details.

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 level data for a specific date. Returns stress levels throughout the day (0-100 scale), with 0-25 resting, 26-50 low, 51-75 medium, 76-100 high stress. Includes overall stress level, durations by category, and detailed timestamp values.

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 detailed all-day stress data with full breakdown.

Get floors climbed and descended for a specific date, with the 15-minute breakdown.

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 with optional body composition data.

Delete a weigh-in record.

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.

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 with optional filtering by type.

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.

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.