Garmin Connect Health Data Skill

Fetch comprehensive health & fitness data from Garmin Connect for your AI agent.

Data Coverage

Category	Fields
Activity	Steps, distance, calories (active + BMR), floors, intensity minutes
Heart Rate

Min/max/resting heart rate | | Sleep | Duration, score, deep/light/REM/awake breakdown, stress during sleep | | HRV | Last night avg, 5min peak, weekly avg, status (balanced/unbalanced), baseline | | Body Battery | Current level, daily min/max | | SpO2 | Average and minimum blood oxygen | | Respiration | Waking and sleep breathing rate | | Stress | Average/max, rest/low/medium/high duration breakdown | | Training Status | Overreaching/Highly Active/Productive/Maintaining/Recovery/Detraining + acute/chronic load ratio | | Training Readiness | Score (0-100) | | Fitness Metrics | VO2 Max, fitness age, endurance score, hill score | | Race Predictions | 5K/10K/Half/Marathon predicted times | | Weight/Body Comp | Weight (kg), body fat %, BMI (requires Garmin Index scale) | | Hydration | Intake (ml) vs goal | | Activities | Individual workouts with HR, duration, calories, elevation, training effect | | Weekly Summary | Total/avg steps for the week |

Setup

1. Install dependency

CODEBLOCK0

2. Set credentials (choose one method)

Option A -- Environment variables:
CODEBLOCK1

Option B -- CLI args:
CODEBLOCK2

Option C -- macOS Keychain:
CODEBLOCK3

Option D -- Credentials file:
CODEBLOCK4

3. Set region (China accounts only)

If your Garmin account was registered in China, add this to your shell profile (~/.zshrc / ~/.bashrc) once:

CODEBLOCK5

This tells the skill to use connect.garmin.com.cn instead of the global endpoint -- more reliable for mainland China IPs and prevents 429 rate-limit errors. Skip this step if you have a global Garmin account.

4. First run

First login may require MFA verification. You'll be prompted to enter a code sent to your email.

5. Use with OpenClaw

Ask your AI agent:

• - "Show my health data"
• "How did I sleep last night?"
• "What's my HRV?"
• "Am I overtraining?"

Usage

CODEBLOCK6

Data Storage

• - ~/.garmin_health/YYYY-MM-DD.json -- Daily snapshots
• INLINECODE4 -- Most recent fetch
• INLINECODE5 -- OAuth token cache

Override with env vars:

• - GARMIN_DATA_DIR -- Change data directory
• INLINECODE7 -- Change token cache directory
• INLINECODE8 -- Use Garmin Connect CN endpoint (set once in shell profile)

Supported Languages

All labels and output in English. JSON field names are English by design.

Security & Privacy

• - Your credentials only -- this skill authenticates with Garmin Connect using your own account credentials. No credentials are shared with or stored by this skill.
• Local storage only -- all fetched health data is saved as JSON files on your own machine. No data is sent to any third party.
• Token caching -- after first login, an OAuth token is cached locally (~/.garminconnect/). Subsequent runs reuse this token and do not re-send your password.
• Recommended auth -- use macOS Keychain or environment variables rather than --password CLI flag to avoid password exposure in shell history.
• Official API only -- all requests go directly to connect.garmin.com (or connect.garmin.com.cn for CN accounts). No proxies or intermediaries.

Requirements

• - Python 3.10+
• INLINECODE13 library
• A Garmin Connect account
• Device: Any Garmin watch/fitness tracker synced to Garmin Connect