LaunchKit · 2026
Back to Skills

garmin-cli

Access Garmin Connect health, fitness, and activity data via a non-interactive CLI.

0
1.4k downloads
by @voydz

Setup & Installation

openclaw skills install @voydz/garmin-cli

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install garmin-cli

Version History

v1.0.5Mar 3, 2026 - Version note by skill developer:

- Removed the file: _meta.json. - Updated documentation to clarify that gc metrics commands support summary queries and added a note on how `vo2max` is resolved for the summary. - Enhanced examples and API usage documentation to include more raw API call patterns. - Minor adjustments to option lists and metric command documentation for clarity.

What This Skill Does

Provides CLI access to Garmin Connect health and fitness data via the `gc` command. Covers activities, daily health metrics, sleep, stress, body battery, workouts, devices, and raw API endpoints. Supports JSON output for programmatic use.

Garmin Connect has no official public API, so this CLI is the only way to script or automate access to Garmin data without a browser.

When to use it

  • Querying today's step count from a shell script
  • Downloading a recent run as a GPX file for route analysis
  • Checking HRV and training readiness before a workout
  • Exporting last week's sleep data to a file
  • Creating and uploading structured workout plans programmatically

Example Workflow

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: Show me my sleep and body battery data from yesterday as JSON

AGENT
  1. 1Run `gc sleep yesterday --format json` to fetch sleep stages and duration
  2. 2Run `gc battery yesterday --format json` to fetch body battery levels and events
  3. 3Return both JSON responses to the user
OUTPUT

Sleep stages, duration, and score alongside body battery levels and drain events for the previous day

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

Garmin Connect accountgarmin-cli binary installed via Homebrew tap: `brew tap voydz/homebrew-tap && brew install garmin-cli`