mcpField
G
garmin-connect

garmin-connect

github.com/eddmannOther15283 installsUpdated 23w ago
Repository

About garmin-connect

garmin-connect is a skill for querying and managing Garmin Connect data through the `garmin-connect` CLI. It covers activity, athlete, health, training, and weight data.

Key features

  1. 01Query aggregated profile and health context
  2. 02List and manage activities
  3. 03Read athlete statistics
  4. 04Inspect health and training metrics
  5. 05Manage weight records

Use cases

  1. 01Review recent activities
  2. 02Check sleep or heart-rate data
  3. 03Inspect training readiness and VO2 max
  4. 04Track weight records

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/eddmann/garmin-connect-cli --skill garmin-connect

After installing, type/garmin-connectin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

LICENSE
Makefile
AGENTS.md
CLAUDE.md
CHANGELOG.md
.gitignore
.python-version
README.md
pyproject.toml
install-skill.sh
install.sh
.github/workflows/
release.yml
deploy-pages.yml
test.yml
site/
index.html
src/garmin_connect_cli/
__init__.py
cli.py
__main__.py
client.py
core.py
config.py
output.py
src/garmin_connect_cli/commands/
__init__.py
activities.py
training.py
auth.py
athlete.py
weight.py
context.py
health.py

Details

From the project README

Garmin Connect CLI Skill

Query and manage Garmin Connect data via the garmin-connect CLI.

Prerequisites

  • Install CLI: curl -fsSL https://raw.githubusercontent.com/eddmann/garmin-connect-cli/main/install.sh | sh
  • Authenticate: garmin-connect auth login (email/password, supports MFA)

Quick Context

Get aggregated data in one call:

garmin-connect context                      # Full context: profile, stats, health, activities
garmin-connect context --activities 10      # More recent activities
garmin-connect context --focus stats,health # Specific sections only

Commands

Run garmin-connect --help or garmin-connect <command> --help to discover all options.

Activities
garmin-connect activities list [--after DATE] [--before DATE] [--limit N] [--type TYPE]
garmin-connect activities get <ID> [--details]
garmin-connect activities splits <ID>
garmin-connect activities download <ID> [--format TCX|GPX|FIT] [-o FILE]
garmin-connect activities upload <FILE>
garmin-connect activities delete <ID> [--force]
Athlete
garmin-connect athlete              # Profile
garmin-connect athlete stats        # Daily statistics
garmin-connect athlete summary      # Comprehensive stats + body metrics
Health
garmin-connect health sleep [--date DATE]
garmin-connect health heart-rate [--date DATE]
garmin-connect health steps [--date DATE]
garmin-connect health stress [--date DATE]
garmin-connect health body-battery [--date DATE]
garmin-connect health rhr [--date DATE]
Training
garmin-connect training status [--date DATE]     # Productive, Peaking, etc.
garmin-connect training readiness [--date DATE]  # Readiness score (0-100)
garmin-connect training vo2max [--date DATE]
garmin-connect training hrv [--date DATE]
garmin-connect training fitness-age
Weight
garmin-connect weight list [--start DATE] [--end DATE]
garmin-connect weight get [--date DATE]
garmin-connect weight log <WEIGHT_KG> [--date DATE]

Data Units

FieldUnit
distancemeters
duration, movingTimeseconds
averageSpeed, maxSpeedm/s
elevationmeters
datesISO8601

Common Patterns

# Recent activities
garmin-connect activities list --limit 10

# This month's activities
garmin-connect activities list --after 2025-12-01

# Filter with jq
garmin-connect activities list | jq '[.[] | select(.activityType.typeKey=="running")]'

# Total distance
garmin-connect activities list | jq '[.[].distance] | add'

Auth Status

garmin-connect auth status    # Check if authenticated
garmin-connect auth login     # Login with email/password (supports MFA)
garmin-connect auth logout    # Clear stored tokens

Activity Types

running, cycling, swimming, walking, hiking, trail_running, open_water_swimming, indoor_cycling, virtual_cycling, strength_training, cardio, yoga, pilates, elliptical, indoor_rowing, other

Exit Codes

  • 0 = Success
  • 1 = General error
  • 2 = Auth error (run garmin-connect auth login)

Comments

Markdown supported