Skill: Garmin Connect (Fixed)

Owner: GodsBoy

Summary: Garmin Connect integration for Clawdbot: sync fitness data (steps, HR, calories, workouts, sleep) every 5 minutes using OAuth.

Tags: latest:1.1.0

Version history:

v1.1.0 | 2026-01-28T07:43:19.022Z | user

Fork of garmin-connect v1.0.0 with fixes: Fixed daily summary 403 error (display_name was None - now fetches from socialProfile endpoint). Fixed requirements.txt (garminconnect>=0.3.2 doesn't exist, corrected to >=0.2.38). All data (steps, HR, calories, sleep, workouts) now works. Contributed by @GodsBoy7777.

Archive index:

Archive v1.1.0: 10 files, 10838 bytes

Files: README.md (3570b), requirements.txt (62b), scripts/garmin-auth-oauth.py (2066b), scripts/garmin-auth.py (1548b), scripts/garmin-cron.sh (434b), scripts/garmin-formatter.py (3112b), scripts/garmin-sync-oauth.py (4453b), scripts/garmin-sync.py (5563b), SKILL.md (4107b), _meta.json (139b)

File v1.1.0:SKILL.md

---

name: garmin-connect description: "Garmin Connect integration for Clawdbot: sync fitness data (steps, HR, calories, workouts, sleep) every 5 minutes using OAuth."

Garmin Connect Skill

Sync all your Garmin fitness data to Clawdbot:

• 🚶 Daily Activity: Steps, heart rate, calories, active minutes, distance
• 😴 Sleep: Duration, quality, deep/REM/light sleep breakdown
• 🏋️ Workouts: Recent activities with distance, duration, calories, heart rate
• ⏱️ Real-time sync: Every 5 minutes via cron

Quick Start

1. Install Dependencies

pip install -r requirements.txt

2. OAuth Authentication (One-time)

python3 scripts/garmin-auth.py your-email@gmail.com your-password

This saves your OAuth session to ~/.garth/session.json — fully local and secure.

3. Test Sync

python3 scripts/garmin-sync.py

You should see JSON output with today's stats.

4. Set Up 5-Minute Cron

Add to your crontab:

*/5 * * * * /home/user/garmin-connect-clawdbot/scripts/garmin-cron.sh

Or manually:

*/5 * * * * python3 /home/user/garmin-connect-clawdbot/scripts/garmin-sync.py ~/.clawdbot/.garmin-cache.json

5. Use in Clawdbot

Import and use in your scripts:

from scripts.garmin_formatter import format_all, get_as_dict

# Get all formatted data
print(format_all())

# Or get raw dict
data = get_as_dict()
print(f"Steps today: {data['summary']['steps']}")

Features

✅ OAuth-based (secure, no password storage) ✅ All metrics: activity, sleep, workouts ✅ Local caching (fast access) ✅ Cron-friendly (5-minute intervals) ✅ Easy Clawdbot integration ✅ Multi-user support

Data Captured

Daily Activity (summary)

• steps: Daily step count
• heart_rate_resting: Resting heart rate (bpm)
• calories: Total calories burned
• active_minutes: Intensity minutes
• distance_km: Distance traveled

Sleep (sleep)

• duration_hours: Total sleep time
• duration_minutes: Sleep in minutes
• quality_percent: Sleep quality score (0-100)
• deep_sleep_hours: Deep sleep duration
• rem_sleep_hours: REM sleep duration
• light_sleep_hours: Light sleep duration
• awake_minutes: Time awake during sleep

Workouts (workouts)

For each recent workout:

• type: Activity type (Running, Cycling, etc.)
• name: Activity name
• distance_km: Distance traveled
• duration_minutes: Duration of activity
• calories: Calories burned
• heart_rate_avg: Average heart rate
• heart_rate_max: Max heart rate

Cache Location

By default, data is cached at: ~/.clawdbot/.garmin-cache.json

Customize with:

python3 scripts/garmin-sync.py /custom/path/cache.json

Files

| File | Purpose | |------|---------| | garmin-auth.py | OAuth setup (run once) | | garmin-sync.py | Main sync logic (run every 5 min) | | garmin-formatter.py | Format data for display | | garmin-cron.sh | Cron wrapper script | | requirements.txt | Python dependencies |

Troubleshooting

OAuth authentication fails

• Check email/password
• Disable 2FA on Garmin account (or use app password)
• Garmin servers might be rate-limiting — wait 5 minutes

No data appears

1. Sync your Garmin device with the Garmin Connect app
2. Wait 2-3 minutes for data to sync
3. Check that data appears in Garmin Connect web/app
4. Then run garmin-sync.py again

Permission denied on cron

chmod +x scripts/garmin-cron.sh
chmod +x scripts/garmin-sync.py
chmod +x scripts/garmin-auth.py

Cache file not found

Run garmin-sync.py at least once to create cache:

python3 scripts/garmin-sync.py

Usage Examples

from scripts.garmin_formatter import format_all, get_as_dict

# Get formatted output
print(format_all())

# Get raw data
data = get_as_dict()
if data:
    print(f"Sleep: {data['sleep']['duration_hours']}h")
    print(f"Steps: {data['summary']['steps']:,}")

License

MIT — Use, fork, modify freely.

---

Made for Clawdbot | Available on ClawdHub

File v1.1.0:README.md

Garmin Connect Integration for Clawdbot

Sync your Garmin fitness data (steps, HR, calories, workouts, sleep) automatically to Clawdbot every 5 minutes.

Quick Start

1. Install Dependencies

pip install -r requirements.txt

2. Authenticate with OAuth

Run the authentication script:

python3 scripts/garmin-auth.py your-email@gmail.com your-password

This saves your OAuth session to ~/.garth/session.json (local, secure).

⚠️ Keep this file safe — it contains your Garmin OAuth token.

3. Test

python3 scripts/garmin-sync.py

You should see JSON output with your current Garmin data.

4. Set Up Cron (5-minute sync)

Add to your crontab:

*/5 * * * * python3 /path/to/scripts/garmin-sync.py

5. Use in Your Scripts

Import Garmin data in any Clawdbot script:

from garmin_connect_clawdbot.scripts.garmin_formatter import format_all, get_as_dict

# Get all formatted data
all_data = format_all()
print(all_data)

# Or get raw dictionary
data = get_as_dict()
steps = data['summary']['steps']
sleep_hours = data['sleep']['duration_hours']

Features

• ✅ OAuth-based authentication (secure)
• ✅ Real-time sync every 5 minutes
• ✅ Sleep quality tracking (duration, deep/REM/light sleep)
• ✅ Daily activity metrics (steps, HR, calories, distance)
• ✅ Workout tracking (all activity types)
• ✅ Body battery monitoring
• ✅ Local caching (JSON)
• ✅ Easy Clawdbot integration

Scripts

| Script | Purpose | |--------|---------| | garmin-auth.py | OAuth authentication (run once) | | garmin-sync.py | Sync all data from Garmin | | garmin-formatter.py | Format data for display | | garmin-cron.sh | Wrapper for cron jobs |

Data Caching

Data is cached locally in JSON format for quick access without constant API calls.

Data Structure

The cached data contains:

• summary: Daily activity (steps, heart rate, calories, active minutes, distance)
• sleep: Sleep metrics (duration, quality, deep/REM/light sleep breakdown)
• workouts: Recent activities (type, distance, duration, calories, heart rate)

Usage Examples

Format All Data

from scripts.garmin_formatter import format_all

output = format_all()  # Returns formatted string
print(output)

Access Raw Data

from scripts.garmin_formatter import get_as_dict

data = get_as_dict()
if data:
    print(f"Sleep: {data['sleep']['duration_hours']}h")
    print(f"Steps: {data['summary']['steps']:,}")
    print(f"Workouts: {len(data['workouts'])} activities")

Format Specific Metrics

from scripts.garmin_formatter import format_daily_summary, format_sleep, format_workouts

# Use individually
print(format_daily_summary())
print(format_sleep())
print(format_workouts())

Troubleshooting

Authentication Failed

• Check email/password
• Ensure 2FA is OFF on Garmin (or use app-specific password)
• Garmin servers might rate-limit — wait 5 minutes

No Sleep Data

• Sync your Garmin device with the Garmin Connect app
• Sleep must be tracked while wearing device
• Data available ~1 hour after waking

Missing Workouts

• Sync device → Garmin Connect app
• Confirm workout saved in Garmin app
• Check garmin-sync.py logs

Data not syncing

Run the sync script manually:

python3 scripts/garmin-sync.py

Check the output for errors.

License

MIT — Use freely, fork, modify as needed.

---

Made for Clawdbot | Available on ClawdHub

File v1.1.0:_meta.json

{ "ownerId": "kn70jpv4vft60w34b6sa1p6dqh8024yf", "slug": "garmin-connect-fixed", "version": "1.1.0", "publishedAt": 1769586199022 }

File v1.1.0:requirements.txt

garminconnect>=0.2.38 requests>=2.28.0 python-dateutil>=2.8.2