Garmin Connect CLI

This skill provides read access to Garmin Connect health and fitness data through the gc CLI.

Setup

1. Install via Homebrew tap:

   brew tap voydz/homebrew-tap
   brew install garmin-cli
   

2. Authentication:

   gc login --email [email protected] --password secret
   # With MFA:
   gc login --email [email protected] --password secret --mfa 123456
   

3. Verify connection:

   gc status
   

Date Shortcuts

Most commands accept a date shortcut as first argument:

• today — current date
• yesterday — previous date
• week — last 7 days (returns a date range)
• month — last 30 days (returns a date range)
• YYYY-MM-DD — specific date

Alternatively use --date, --start/--end flags.

Output

All data commands support:

• --format json for machine-readable output (default: table)
• --output FILE to write to a file

Always use --format json when parsing output programmatically.

Usage

# Authentication
gc login --email EMAIL --password PASS [--mfa CODE | --wait-mfa]
gc logout
gc status
gc status --profile

# Daily Health
gc health today
gc steps today
gc steps week
gc steps --weekly --weeks N
gc steps --start DATE --end DATE
gc floors today
gc intensity today
gc intensity --weekly --weeks N
gc events today

# Heart Rate
gc heart today
gc heart resting today

# Sleep
gc sleep today

# Stress & Body Battery
gc stress today
gc stress --weekly --weeks N
gc stress all-day today
gc battery today
gc battery --start DATE --end DATE
gc battery --events today

# Vitals
gc respiration today
gc spo2 today
gc blood-pressure today [--end DATE]
gc lifestyle today

# Hydration
gc hydration today

# Activities
gc activities                                     # List recent (default 20)
gc activities --limit N --offset N --type TYPE
gc activities --start DATE --end DATE [--type TYPE]
gc activities today                               # Activities for a date
gc activities last                                # Most recent activity
gc activities get ID                              # Activity summary by ID
gc activities count                               # Total count
gc activities details ID
gc activities splits ID
gc activities typed-splits ID
gc activities split-summaries ID
gc activities weather ID
gc activities hr-zones ID
gc activities power-zones ID
gc activities exercise-sets ID
gc activities types                               # List all activity types
gc activities gear ID                             # Gear used for activity
gc activities progress --start DATE --end DATE --metric distance|duration|elevation
gc activities download ID --format fit|tcx|gpx|kml|csv [-o FILE]
gc activities upload FILE                         # .fit, .gpx, .tcx

# Body & Weight
gc body today [--end DATE]
gc body weighins today
gc body weighins --start DATE --end DATE