OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add eddmann/garmin-connect-cli --skill garmin-connect
Query Garmin Connect fitness and health data including activities, athlete stats, sleep, heart rate, stress, and body battery. Use when the user asks about Garmin data, workouts, training, or health metrics.
npx skills add eddmann/garmin-connect-cli --skill garmin-connect
Query and manage Garmin Connect data via the garmin-connect CLI.
curl -fsSL https://raw.githubusercontent.com/eddmann/garmin-connect-cli/main/install.sh | shgarmin-connect auth login (email/password, supports MFA)Get aggregated data in one call:
Run garmin-connect --help or garmin-connect <command> --help to discover all options.
| Field | Unit |
|---|---|
| distance | meters |
| duration, movingTime | seconds |
| averageSpeed, maxSpeed | m/s |
| elevation | meters |
| dates | ISO8601 |
running, cycling, swimming, walking, hiking, trail_running, open_water_swimming, indoor_cycling, virtual_cycling, strength_training, cardio, yoga, pilates, elliptical, indoor_rowing, other
garmin-connect auth login)garmin-connect activities list [--after DATE] [--before DATE] [--limit N] [--type TYPE]
garmin-connect activities get <ID> [--details]
garmin-connect activities splits <ID>
garmin-connect activities download <ID> [--format TCX|GPX|FIT] [-o FILE]
garmin-connect activities upload <FILE>
garmin-connect activities delete <ID> [--force]garmin-connect athlete # Profile
garmin-connect athlete stats # Daily statistics
garmin-connect athlete summary # Comprehensive stats + body metricsgarmin-connect health sleep [--date DATE]
garmin-connect health heart-rate [--date DATE]
garmin-connect health steps [--date DATE]
garmin-connect health stress [--date DATE]
garmin-connect health body-battery [--date DATE]
garmin-connect health rhr [--date DATE]garmin-connect training status [--date DATE] # Productive, Peaking, etc.
garmin-connect training readiness [--date DATE] # Readiness score (0-100)
garmin-connect training vo2max [--date DATE]
garmin-connect training hrv [--date DATE]
garmin-connect training fitness-agegarmin-connect weight list [--start DATE] [--end DATE]
garmin-connect weight get [--date DATE]
garmin-connect weight log <WEIGHT_KG> [--date DATE]# Recent activities
garmin-connect activities list --limit 10
# This month's activities
garmin-connect activities list --after 2025-12-01
# Filter with jq
garmin-connect activities list | jq '[.[] | select(.activityType.typeKey=="running")]'
# Total distance
garmin-connect activities list | jq '[.[].distance] | add'garmin-connect auth status # Check if authenticated
garmin-connect auth login # Login with email/password (supports MFA)
garmin-connect auth logout # Clear stored tokens