garmin-connect

# 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 <i...