garmin-exporter 0.0.3

Export Garmin Connect activities and wellness data to CSV/JSON.

garmin-exporter

Export your Garmin Connect activities (CSV), per-run km splits (CSV), and wellness metrics - sleep, HRV, VO2max, Training Status, plus your profile (age, sex, weight, height) and configured thresholds (LTHR, threshold pace) (JSON).

Install

The package is published on PyPI, so the recommended way to install it is with uv or pip:

# with uv (recommended)
uv tool install garmin-exporter

# or with pip
pip install garmin-exporter

Quickstart

# Show help
garmin-exporter --help

# Export activities to CSV + a year of wellness metrics (sleep, HRV, VO2max,
# profile, thresholds, ...) to JSON
garmin-exporter --wellness

# Shorter wellness window (e.g. last 30 days)
garmin-exporter --wellness --wellness-days 30

# Also add per-activity HR time-in-zones
garmin-exporter --hr-zones

# Write per-run km splits to activities.splits.csv
garmin-exporter --splits

On the first run it asks for your Garmin email, password, and MFA code (if enabled), then stores the session token in your OS keyring - the password is never saved. Later runs reuse the session.

Options

Flag	Description
-o, --output	Output CSV path (default: activities.csv)
--days-back N	Only the last N days (default: all activities)
--activity-type T	Garmin type key, e.g. running (default: all)
--wellness	Also write <output>.wellness.json
--wellness-days N	Days of wellness history with --wellness (default: 365)
--hr-zones	Add per-activity HR time-in-zones (+1 call each)
--splits	Write per-run km splits to <output>.splits.csv
--reset-login	Forget the stored session and log in again

Development

The project uses Makefile for typical tasks:

• make lint - Ruff check + mypy --strict
• make format - Ruff format
• make clean - Remove cache files