garmin-connect

name	garmin-connect
description	Garmin Connect CLI for activities, health, body composition, workouts, devices, gear, goals, and more.
homepage	https://github.com/bpauli/gccli
metadata	{"openclaw":{"emoji":"⌚","os":["darwin","linux"],"requires":{"bins":["gccli"]},"install":[{"id":"homebrew","kind":"homebrew","formula":"bpauli/tap/gccli","bins":["gccli"],"label":"Homebrew (recommended)"},{"id":"source","kind":"source","url":"https://github.com/bpauli/gccli","bins":["gccli"],"label":"Build from source (Go 1.24+)"}]}}

gccli

Use gccli for Garmin Connect health, fitness, and activity data. Requires Garmin SSO authentication.

Setup (once)

• gccli auth login [e-mail] (opens browser for Garmin SSO)
• Headless: gccli auth login [e-mail] --headless (with --mfa-code <code> for MFA)
• Set default account: export GCCLI_ACCOUNT=[e-mail]
• Verify: gccli auth status

Output

• Default: human-friendly tables. Use --json / -j for JSON, --plain for TSV.
• Data goes to stdout, messages/errors to stderr.
• Always use --json when parsing output programmatically.

Date shortcuts

• today, yesterday, 3d (N days ago), YYYY-MM-DD (specific date).
• Use --start/--end flags for date ranges.

Common commands

• Auth status: gccli auth status
• Auth token (for scripting): gccli auth token
• Remove credentials: gccli auth remove
• List activities: gccli activities list --limit 20
• List activities by type: gccli activities list --type running
• Activity count: gccli activities count
• Search activities: gccli activities search --start-date 2024-01-01 --end-date 2024-12-31
• Activity summary: gccli activity summary <id>
• Activity details: gccli activity details <id>
• Activity splits: gccli activity splits <id>
• Activity weather: gccli activity weather <id>
• Activity HR zones: gccli activity hr-zones <id>
• Activity power zones: gccli activity power-zones <id>
• Activity exercise sets: gccli activity exercise-sets <id>
• Activity gear: gccli activity gear <id>
• Download activity (FIT): gccli activity download <id> --format fit
• Download activity (GPX): gccli activity download <id> --format gpx --output track.gpx
• Upload activity: gccli activity upload ./activity.fit
• Create manual activity: gccli activity create --name "Morning Run" --type running --date 2024-06-15T07:30:00 --duration 1800 --distance 5000
• Rename activity: gccli activity rename <id> "New Name"
• Retype activity: gccli activity retype <id> running
• Delete activity: gccli activity delete <id> --force
• Health summary: gccli health summary [date]
• Steps chart: gccli health steps [date]
• Daily steps range: gccli health steps daily --start 2024-01-01 --end 2024-01-31
• Weekly steps: gccli health steps weekly --weeks 4
• Heart rate: gccli health hr [date]
• Resting HR: gccli health rhr [date]
• Floors climbed: gccli health floors [date]
• Sleep:

Notes

• Set GCCLI_ACCOUNT=[e-mail] to avoid repeating --account.
• For scripting, use --json for JSON output or --plain for TSV.
• Dates support today, yesterday, 3d, or YYYY-MM-DD.
• Tokens are stored securely in the OS keyring (macOS Keychain, Linux Secret Service, file fallback).
• Tokens auto-refresh on 401; automatic retry on 429/5xx with exponential backoff.
• For Garmin China accounts: export GCCLI_DOMAIN=garmin.cn.
• Confirm before deleting activities/workouts (or use --force).
• Download formats: FIT (default), GPX, TCX, KML, CSV.
• Workout step format: type:duration[@target:low-high] — types: warmup, run, recovery, cooldown; targets: pace (min:sec), hr (bpm), power (watts), cadence.