garmin-exporter 0.0.2

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

garmin-exporter

Export your Garmin Connect activities (CSV) and wellness metrics - sleep, HRV, VO2max, Training Status, Training Readiness (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 + wellness metrics (sleep, HRV, VO2max, ...) to JSON
garmin-exporter --wellness

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

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
--hr-zones	Add per-activity HR time-in-zones (+1 call each)
--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