A robust integration that synchronizes detailed Garmin fitness, sleep, and workout metrics to your local environment every five minutes.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install garmin-connect-fixed
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install garmin-connect-fixed 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 seamless bridge between your wearable devices and your automated workflows. By utilizing this contribution to the Openclaw Skills ecosystem, developers can programmatically access granular health metrics including heart rate, activity levels, and recovery data. It prioritizes security by using OAuth authentication, ensuring that your credentials are never stored after the initial local session is established.
This integration is designed for high-frequency updates, making it ideal for users who want their AI agents to have near real-time awareness of their physical state. Whether you are building a personal health dashboard or a context-aware productivity tool, this skill ensures your Garmin data is always available locally and ready for processing.
Garmin Connect Use Cases
- Automating daily health summaries and progress reports within an AI assistant.
- Triggering productivity workflows based on sleep quality or recovery scores.
- Consolidating workout history into a private database for long-term health analytics.
- Creating real-time alerts or dashboards that visualize heart rate and step count trends.
How Garmin Connect Works
- Initialize the environment by installing necessary Python dependencies.
- Execute a one-time OAuth authentication script to generate a secure local session token.
- Configure a cron job or scheduled task to run the synchronization script every five minutes.
- The synchronization logic fetches the latest metrics from Garmin Connect and updates a local JSON cache file.
- The provided formatter utility parses the cached data for use in Openclaw Skills or other custom scripts.
Garmin Connect Setup
First, install the required dependencies:
pip install -r requirements.txt
Perform the initial OAuth authentication (your credentials are used only to generate a local session file):
python3 scripts/garmin-auth.py [email protected] your-password
Run a manual sync to verify the connection:
python3 scripts/garmin-sync.py
Finally, automate the process by adding a entry to your crontab:
*/5 * * * * python3 /path/to/garmin-sync.py ~/.clawdbot/.garmin-cache.json
Garmin Connect Data Schema & Taxonomy
The skill organizes data into a structured JSON cache for easy consumption. Below is the metadata taxonomy:
| Category | Key Metrics | Description |
|---|---|---|
| Summary | steps, heart_rate_resting, active_minutes, distance_km | Daily activity and cardiovascular overview. |
| Sleep | duration_hours, quality_percent, deep_sleep_hours, rem_sleep_hours | Detailed breakdown of sleep stages and quality. |
| Workouts | type, name, duration_minutes, heart_rate_avg | Log of specific activity sessions and intensity. |
Garmin Connect Advanced Features
- Secure OAuth-based session management using the Garth library to prevent password exposure.
- Intelligent local caching mechanism for low-latency data access within Openclaw Skills.
- Cron-optimized shell wrappers for reliable background execution.
- Multi-user support allowing for the management of multiple Garmin profiles from a single instance.
- Customizable data paths to integrate with specific file structures or external databases.
SKILL.md
Loading
Related Openclaw Skills
LinkedIn Post Search
A powerful skill for searching and extracting LinkedIn posts, engagement metrics, and author data via the Apify platform.
Buku Bookmark Manager
A high-performance CLI bookmarking tool with a SQLite backend designed for seamless terminal-based link organization.
People Relationship Map
A lightweight personal CRM and relationship graph that tracks individuals and their connections using Obsidian-compatible Markdown and JSON.
ClawWatch
A CLI-driven asset tracker for crypto and stocks designed for AI agents to monitor portfolios and market sentiment.
OpenClaw AWS Deploy
A robust automation skill to deploy, manage, and tear down secure OpenClaw agent instances on AWS infrastructure.
Feishu Media Sender
A powerful skill for automating the delivery of multimedia files and structured documents to Feishu chats and users.
Featured*
