Sync Your Garmin Health Data with the Garmin-Pulse Skill: Heart Rate, Sleep, Stress & More

If you wear a Garmin watch and want your AI agent to know about your sleep quality, heart rate variability, stress levels, and workout data, the Garmin-Pulse skill is exactly what you need. This skill syncs your daily health metrics from Garmin Connect directly into readable markdown files that Clawdbot can access and analyze.

Why Sync Garmin Data?

Imagine asking your AI assistant:

• "How did I sleep last night?"
• "What's my Body Battery at?"
• "Show me my heart rate trends this week"
• "Was yesterday a high-stress day?"

Without access to your health data, your agent can only guess. With Garmin-Pulse, your agent has direct access to your metrics and can provide personalized insights based on your actual data.

What Data Does It Capture?

The skill syncs a comprehensive set of health metrics:

• Sleep: Duration, sleep stages, sleep score
• Activity: Steps, calories, active minutes, intensity minutes
• Heart Rate: Resting HR, max HR, average throughout the day
• Stress: Stress levels, Body Battery charge/drain
• HRV: Heart Rate Variability (key recovery metric)
• SpO2: Blood oxygen saturation
• Weight: If you use a Garmin scale

All data is stored as daily markdown files in a health/ directory, one file per day (e.g., 2026-02-18.md).

Installation

Install the skill using the ClawdHub CLI:

clawdhub install garmin-pulse

The skill requires uv (Astral's fast Python package manager) for running the sync script. Install it via Homebrew:

brew install uv

One-Time Authentication Setup

Garmin Connect doesn't offer a public OAuth API, so the skill uses a one-time email/password login to obtain OAuth tokens. These tokens are cached locally for approximately one year.

Important: Run this setup in your terminal (not through your AI agent) to keep your password secure:

uv run skills/garmin-pulse/scripts/sync_garmin.py --days 7

The script will prompt for your password interactively via getpass — it's never echoed, stored in history, or passed as an argument. On success, you'll see:

Note: Garmin's Cloudflare protection can sometimes interfere. The skill uses cloudscraper to work around this. If you have 2FA enabled, you may need to temporarily disable it during setup.

Syncing Your Data

Once authenticated, syncing is straightforward:

Sync today's data:

uv run skills/garmin-pulse/scripts/sync_garmin.py --days 7

Sync a specific date:

uv run skills/garmin-pulse/scripts/sync_garmin.py --days 7

Backfill the last 7 days:

uv run skills/garmin-pulse/scripts/sync_garmin.py --days 7

Automate with Cron

The best part? You can schedule automatic daily syncs using Clawdbot's cron system. Set up a morning job to sync the previous day's complete data:

"Sync my Garmin health data every morning at 7 AM"

Your agent will have fresh health data ready every day without manual intervention.

Using the Data

After syncing, your health files live at skills/garmin-pulse/health/YYYY-MM-DD.md. When you ask health-related questions, Clawdbot reads the relevant day's file and provides insights based on your actual metrics.

Example questions your agent can now answer:

• "Compare my sleep this week vs last week"
• "What time did my stress peak yesterday?"
• "How's my HRV trending?"
• "Did I hit my step goal today?"

Tips & Best Practices

• Initial backfill: After setup, sync the last 14-30 days to give your agent historical context
• Morning sync: Schedule syncs after your Garmin has uploaded overnight data (typically by 6-7 AM)
• Token refresh: If syncs start failing after ~1 year, re-run the setup command to refresh tokens
• Privacy: The cached tokens in ~/.garminconnect/ grant access to your Garmin account — treat them like passwords

Conclusion

The Garmin-Pulse skill bridges your wearable health data with your AI agent, enabling truly personalized health insights. Whether you're tracking recovery, monitoring stress, or optimizing sleep, having your agent understand your biometrics opens up powerful new use cases.

Links:

• Garmin-Pulse on ClawdHub
• uv Documentation