diegoscarabelli / garmin-health-data
A simple Python CLI to download Garmin Connect data as local files and load them into a SQLite database for analysis
Why this job: works in the areas we cover, but does not say which job it does
What it does
- Comprehensive data. a single garmin extract command downloads sleep, HRV, stress, body battery, heart rate, respiration, VO2 max, training metrics, menstrual cycle, and activity files in FIT or TCX format (time-series, laps, splits, per-len
- Multi-account. one database across multiple Garmin Connect accounts (e.g. family members). Run garmin auth once per account; extraction discovers and processes them automatically.
- Resilient pipeline. four-folder lifecycle (ingest/process/storage/quarantine), auto-resume from the last update, crash recovery, and per-date / per-data-type / per-activity / per-FileSet failure isolation. Original files are preserved on di
- Bounded disk usage. garmin downsample aggregates per-second sensor data into time-bucketed records, and garmin prune deletes the source rows. Together they let you run a multi-year history without unbounded growth (activity_ts_metric is ~93
- Self-contained Garmin client. bundled SSO/MFA login client, with no third-party Garmin Connect client library dependency.
Get started
pip install garmin-health-dataYou need: Python 3.10 or higher; SQLite 3.35.0 or higher; Garmin Connect account
- Maintenance
- Active
- Last commit 53 days ago
- Stars
- 129
- On GitHub
- Licence
- Apache-2.0
- Allows business use
- Downloads for
- None listed
- No release files
- Latest version
- v2.16.0
- Released 2 months ago
- Built with
- Python
- 100% of the code
Is it looked after?
- Contributors
- 3
- Last 90 days
- Issues
- 92% closed
- 3 still open
- Pull requests
- 57 merged
- 0 waiting
- Releases
- 26
- 23 in the last year
- No contributing guide
- No security policy
- No code of conduct
Similar repos
| Repo | Stars | Last commit | Licence | Downloads for |
|---|---|---|---|---|
| jimmykane / quantified-self | 236 | yesterday | Custom | No downloads |
More: languages, topics and project record
Languages
- Python 100%
- Makefile <1%
Topics
- ai-agents
- cli
- etl
- fitdecode
- fitness
- garmin
- garmin-connect
- health-data
- heart-rate
- python
- quantified-self
- sleep-tracking
Project record
- JobOther AI tools
- StatusListed
- Commits260
- Forks17
- Watching4
- Stars in 28 days+6
- CreatedOct 14, 2025
- First seen by usNov 7, 2026
- CheckedNov 7, 2026
