garmin-connect

What This Skill Does

The garmin-connect skill provides a robust interface to the Garmin Connect platform, enabling OpenClaw AI agents to interact with a vast array of health, fitness, and activity metrics. By leveraging the gccli underlying framework, this skill allows for the authentication, retrieval, and management of user data directly from the command line. Users can perform granular queries for activity logs, sleep analysis, heart rate variations, body battery, stress levels, and much more. It serves as a bridge between a personal Garmin ecosystem and automated workflows, allowing for seamless data syncing, reporting, and management.

Installation

To integrate this capability into your agent environment, run the following command within your shell or terminal: clawhub install openclaw/skills/skills/bpauli/garmin-connect-cli

After installation, initialize your connection by running gccli auth login [email protected]. For headless environments, use the --headless flag combined with your MFA code. You can verify your connection status at any time with gccli auth status.

Use Cases

This skill is ideal for fitness tracking automation, health dashboarding, and administrative tasks. Use it to automatically export workout data for performance analysis, track progress against long-term fitness goals, or ingest body battery and sleep data into other productivity applications. It is particularly useful for athletes needing to log manual activities, rename sessions, or bulk-export GPX files for mapping software.

Example Prompts

1. "Check my recent workout performance and tell me my heart rate zones for the last running activity."
2. "Get my average resting heart rate and sleep duration from yesterday."
3. "Export my latest activity as a GPX file and save it to the current directory."

Tips & Limitations

Always append the --json flag when utilizing this skill within scripts to ensure machine-readable output. Remember that the skill requires periodic authentication; use the auth token command if you need credentials for persistent scripts. Note that the accuracy of the returned health data depends entirely on the synchronization status of your physical Garmin hardware. Handle sensitive health data with care, as the gccli tool retrieves your complete personal biometric history.