Returns step-by-step instructions for authenticating with Garmin Connect. Requires the Playwright MCP server to be installed. After following these steps, ALWAYS call the check-session tool to verify the login worked.

Check if the saved Garmin Connect session is still valid. MUST be called after garmin-login to verify authentication worked.

List your Garmin Connect activities with pagination

Get full activity summary (name, type, distance, duration, HR, calories, etc.)

Get time-series metrics for an activity (HR, cadence, elevation, pace over time)

Get lap/split data for an activity

Get heart rate time-in-zone breakdown for an activity

Get full-resolution GPS track/polyline for an activity

Get weather conditions during an activity

Get your Garmin Connect user profile and settings

Download the original FIT file for an activity. Returns the file path.

Get daily summary: steps, calories, distance, intensity minutes, floors, etc.

Get heart rate data throughout the day (resting HR, HR timeline)

Get stress level data throughout the day

Get daily wellness summary chart data (combined health metrics)

Get intensity minutes earned for a date

Get daily movement/activity data

Get respiration rate data for a date

Get sleep data: score, duration, stages, SpO2, HRV during sleep

Get today's body battery charged/drained values

Get heart rate variability (HRV) data for a date

Get weight measurements over a date range

Get all personal records with history (fastest mile, longest run, etc.)

Get aggregated fitness stats by activity type over a date range

Get latest VO2 Max / fitness level estimate

Get your configured heart rate zone boundaries

Get training readiness score for a date (based on sleep, recovery, training load)

Get sleep statistics over a date range (averages, trends)

Get monthly calendar with activities, workouts, and events

Get fitness goals

Get all earned badges/achievements

Get badge leaderboard among your connections

Get daily hydration/water intake data

Get power zone configuration for all sports

List your saved workouts

Get a single workout by ID with full step/segment details

Download a workout as a FIT file

Upload a workout from JSON data.

Creates a new workout in Garmin Connect from structured workout data.

IMPORTANT: Step types must use Garmin's DTO format:

• Use "ExecutableStepDTO" for regular steps (warmup, interval, cooldown, recovery)

• Use "RepeatGroupDTO" for repeat/interval groups with numberOfIterations

IMPORTANT: For heart rate zone targets, use "zoneNumber" (1-5), NOT targetValueOne/targetValueTwo. targetValueOne/targetValueTwo are only for absolute value ranges (e.g. pace in m/s, power in watts).

Sport type IDs: 1=running, 2=cycling, 3=swimming, 4=walking, 5=strength_training, 6=fitness_equipment, 7=hiking. Step type IDs: warmup (1), cooldown (2), interval (3), recovery (4), rest (5). End condition IDs: time (2, value in seconds), distance (3, value in meters), lap.button (7, no value), reps (10, value = rep count — use for strength exercises). Target type IDs: no.target (1), speed (2, m/s range via targetValueOne/targetValueTwo), heart.rate.zone (4, use zoneNumber 1-5), power.zone (11, use zoneNumber).

Available Templates: Instead of building workout JSON from scratch, use these MCP resources as starting points:

• workout://templates/simple-run - Basic warmup/run/cooldown structure

• workout://templates/interval-running - Interval training with repeat groups

• workout://templates/tempo-run - Tempo run with heart rate zone targets

• workout://templates/strength-circuit - Strength training circuit structure

• workout://reference/structure - Complete JSON structure reference with all fields

Access these resources using your MCP client's resource reading capability, modify the template as needed, and pass the resulting JSON as the workout parameter.

Example workout structure with HR zone target: { "workoutName": "My Workout", "sportType": {"sportTypeId": 1, "sportTypeKey": "running"}, "workoutSegments": [{ "segmentOrder": 1, "sportType": {"sportTypeId": 1, "sportTypeKey": "running"}, "workoutSteps": [{ "type": "ExecutableStepDTO", "stepOrder": 1, "stepType": {"stepTypeId": 3, "stepTypeKey": "interval"}, "endCondition": {"conditionTypeId": 2, "conditionTypeKey": "time"}, "endConditionValue": 1200.0, "targetType": {"workoutTargetTypeId": 4, "workoutTargetTypeKey": "heart.rate.zone"}, "zoneNumber": 3 }] }] }

Example with RepeatGroupDTO for intervals: { "workoutName": "Interval Run", "sportType": {"sportTypeId": 1, "sportTypeKey": "running"}, "workoutSegments": [{ "segmentOrder": 1, "sportType": {"sportTypeId": 1, "sportTypeKey": "running"}, "workoutSteps": [ { "type": "ExecutableStepDTO", "stepOrder": 1, "stepType": {"stepTypeId": 1, "stepTypeKey": "warmup"}, "endCondition": {"conditionTypeId": 2, "conditionTypeKey": "time"}, "endConditionValue": 600.0, "targetType": {"workoutTargetTypeId": 1, "workoutTargetTypeKey": "no.target"} }, { "type": "RepeatGroupDTO", "stepOrder": 2, "numberOfIterations": 6, "workoutSteps": [ { "type": "ExecutableStepDTO", "stepOrder": 1, "stepType": {"stepTypeId": 3, "stepTypeKey": "interval"}, "endCondition": {"conditionTypeId": 2, "conditionTypeKey": "time"}, "endConditionValue": 60.0, "targetType": {"workoutTargetTypeId": 4, "workoutTargetTypeKey": "heart.rate.zone"}, "zoneNumber": 5 }, { "type": "ExecutableStepDTO", "stepOrder": 2, "stepType": {"stepTypeId": 4, "stepTypeKey": "recovery"}, "endCondition": {"conditionTypeId": 2, "conditionTypeKey": "time"}, "endConditionValue": 90.0, "targetType": {"workoutTargetTypeId": 4, "workoutTargetTypeKey": "heart.rate.zone"}, "zoneNumber": 2 } ] }, { "type": "ExecutableStepDTO", "stepOrder": 3, "stepType": {"stepTypeId": 2, "stepTypeKey": "cooldown"}, "endCondition": {"conditionTypeId": 2, "conditionTypeKey": "time"}, "endConditionValue": 600.0, "targetType": {"workoutTargetTypeId": 1, "workoutTargetTypeKey": "no.target"} } ] }] }

Schedule an existing workout to a date on your calendar. The workout will sync to your device.

Delete a workout from Garmin Connect

Returns a test plan for verifying all garmin-connect-mcp tools work. Call each tool listed and report results.