Garmin Connect for Openclaw

A secure integration to sync Garmin Connect fitness metrics like steps, sleep, and workouts into your AI agent environment.

rayleigh3105
v1.0.0
Jan 28, 2026
5
3.3k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install garmin-connect

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install garmin-connect using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Garmin Connect?

The garmin-connect skill provides a robust bridge between the Garmin ecosystem and your automation workflows. By leveraging Openclaw Skills, developers can pull detailed health telemetry—including resting heart rate, sleep stages, and activity logs—into a local cache for AI analysis or personal dashboards. This integration prioritizes privacy by using OAuth sessions stored locally rather than plaintext passwords.

This skill is designed to work seamlessly within the Clawdbot ecosystem, providing a reliable way to ground your AI agent in real-world physical activity data. Whether you are building a personal health coach or a productivity tracker that adjusts based on sleep quality, this tool handles the complex API interactions and data formatting automatically.

Garmin Connect Use Cases

  • Monitoring daily physical activity levels and step counts via an AI agent.
  • Analyzing sleep quality trends including REM, deep, and light sleep for health optimization.
  • Automating workout logging by syncing recent activity data every five minutes.
  • Triggering specific AI-driven notifications or task adjustments based on heart rate or calorie burn thresholds.

How Garmin Connect Works

  1. The user performs a one-time authentication via OAuth to generate a secure local session file using the garth library.
  2. A synchronization script fetches the latest metrics from Garmin Connect servers.
  3. Data is processed and saved into a local JSON cache file for fast, offline-first access.
  4. A cron job ensures the local cache stays updated every five minutes with the latest telemetry.
  5. The AI agent or custom scripts import the provided formatter to read and display the synced health data for downstream tasks.

Garmin Connect Setup

To get started with this entry in the Openclaw Skills library, install the necessary Python dependencies:

pip install -r requirements.txt

Perform a one-time OAuth authentication to secure your session locally:

python3 scripts/garmin-auth.py [email protected] your-password

Verify the synchronization manually to ensure data is flowing correctly:

python3 scripts/garmin-sync.py

Enable automated updates by adding the following to your crontab for a 5-minute sync interval:

*/5 * * * * python3 /path/to/scripts/garmin-sync.py ~/.clawdbot/.garmin-cache.json

Garmin Connect Data Schema & Taxonomy

The skill organizes data into three primary schemas within a local JSON cache for easy consumption by other Openclaw Skills:

Data Group Key Metrics Captured
Daily Activity steps, heart_rate_resting, total calories, active_minutes, distance_km
Sleep Analysis duration_hours, quality_percent, deep_sleep, rem_sleep, light_sleep, awake_minutes
Workouts activity type, name, distance, duration_minutes, heart_rate_avg, heart_rate_max

Default cache location: ~/.clawdbot/.garmin-cache.json

Garmin Connect Advanced Features

  • Secure OAuth-based authentication ensuring no passwords are stored in plaintext.
  • High-frequency synchronization support via cron-friendly scripts for near real-time data access.
  • Modular Python formatting logic that allows developers to export data as either raw dictionaries or pre-formatted strings.
  • Multi-user support capability by utilizing custom cache paths for different profiles.
  • Local caching architecture to minimize API rate-limiting and ensure high performance for AI queries.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*