Garmin Connect CLI

gccli

Use gccli for Garmin Connect health, fitness, and activity data. Requires Garmin SSO authentication. Setup (once) gccli auth login you@example.com (opens browser for Garmin SSO) Headless: gccli auth login you@example.com --headless (with --mfa-code <code> for MFA) Set default account: export GCCLI_ACCOUNT=you@example.com 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: gccli health sleep [date] Respiration: gccli health respiration [date] SpO2: gccli health spo2 [date] HRV: gccli health hrv [date] Stress: gccli health stress [date] Weekly stress: gccli health stress weekly --weeks 4 Body battery: gccli health body-battery [date] Body battery range: gccli health body-battery range --start 2024-01-01 --end 2024-01-07 Training readiness: gccli health training-readiness [date] Training status: gccli health training-status [date] Fitness age: gccli health fitness-age [date] VO2max / max metrics: gccli health max-metrics [date] Lactate threshold: gccli health lactate-threshold Cycling FTP: gccli health cycling-ftp Race predictions: gccli health race-predictions [date] Race predictions range: gccli health race-predictions range --start 2024-01-01 --end 2024-06-30 Endurance score: gccli health endurance-score [date] Hill score: gccli health hill-score [date] Intensity minutes: gccli health intensity-minutes [date] Weekly intensity minutes: gccli health intensity-minutes weekly --start 2024-01-01 --end 2024-01-31 Wellness events: gccli health events [date] Body composition: gccli body composition [date] Body composition range: gccli body composition --start 2024-01-01 --end 2024-01-31 Weigh-ins: gccli body weigh-ins --start 2024-01-01 --end 2024-01-31 Add weight: gccli body add-weight 75.5 --unit kg Add composition: gccli body add-composition 75.5 --body-fat 15.2 --muscle-mass 35.0 Blood pressure: gccli body blood-pressure --start 2024-01-01 --end 2024-01-31 Add blood pressure: gccli body add-blood-pressure --systolic 120 --diastolic 80 --pulse 65 List workouts: gccli workouts list --limit 20 Workout detail: gccli workouts detail <id> Download workout (FIT): gccli workouts download <id> --output workout.fit Upload workout (JSON): gccli workouts upload ./workout.json Schedule workout: gccli workouts schedule add <id> 2024-06-20 List scheduled workouts: gccli workouts schedule list 2024-06-20 Remove scheduled workout: gccli workouts schedule remove <schedule-id> (use --force to skip confirmation) Delete workout: gccli workouts delete <id> Create running workout with pace: gccli workouts create "Easy Run" --type run --step "warmup:5m" --step "run:20m@pace:5:00-5:30" --step "cooldown:5m" Create workout with HR targets: gccli workouts create "HR Run" --type run --step "warmup:10m" --step "run:20m@hr:140-160" --step "cooldown:10m" Create cycling workout with power: gccli workouts create "FTP Intervals" --type bike --step "warmup:10m" --step "run:5m@power:250-280" --step "recovery:3m" --step "run:5m@power:250-280" --step "cooldown:10m" List courses: gccli courses list Favorite courses: gccli courses favorites Course detail: gccli courses detail <id> Import course from GPX (default: cycling, private): gccli courses import route.gpx Import course with name: gccli courses import route.gpx --name "Sunday Ride" Import course with type: gccli courses import route.gpx --type gravel_cycling Import public course: gccli courses import route.gpx --privacy 1 Send course to device: gccli courses send <course-id> <device-id> Delete course: gccli courses delete <id> (use -f to skip confirmation) List devices: gccli devices list Device settings: gccli devices settings <device-id> Primary device: gccli devices primary Last used device: gccli devices last-used Device alarms: gccli devices alarms Solar data: gccli devices solar <device-id> --start 2024-06-01 --end 2024-06-30 List gear: gccli gear list Gear stats: gccli gear stats <uuid> Gear activities: gccli gear activities <uuid> --limit 20 Gear defaults: gccli gear defaults Link gear: gccli gear link <uuid> <activity-id> Unlink gear: gccli gear unlink <uuid> <activity-id> Goals: gccli goals list --status active Earned badges: gccli badges earned Available badges: gccli badges available In-progress badges: gccli badges in-progress Challenges: gccli challenges list Badge challenges: gccli challenges badge Personal records: gccli records Profile: gccli profile Profile settings: gccli profile settings Hydration: gccli hydration [date] Log water: gccli hydration add 500 Training plans: gccli training plans --locale en Training plan detail: gccli training plan <id> Menstrual cycle: gccli wellness menstrual-cycle --start-date 2024-01-01 --end-date 2024-03-31 Pregnancy summary: gccli wellness pregnancy-summary List events: gccli events list List events from date: gccli events list --start 2024-06-01 --limit 50 Add event: gccli events add --name "Berlin Marathon" --date 2026-09-27 --type running --race --location "Berlin, Germany" --distance 42.195km --time 09:15 --timezone Europe/Berlin Add event with goal and training priority: gccli events add --name "Spring 10K" --date 2026-05-10 --type running --race --distance 10km --goal 40m --training Delete event: gccli events delete <id> (use -f to skip confirmation) Reload data: gccli reload [date] Notes Set GCCLI_ACCOUNT=you@example.com 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.