garmin-connect

What This Skill Does

The Garmin Connect skill for Clawdbot provides a seamless integration between your Garmin wearable ecosystem and your AI agent. By leveraging OAuth for secure authentication, this skill autonomously fetches and caches your health, fitness, and sleep metrics every five minutes. It transforms raw API data into structured, actionable insights, covering daily activity summaries (steps, heart rate, active minutes), detailed sleep quality breakdowns, and comprehensive workout histories. Whether you are tracking performance trends or simply want your AI agent to be aware of your physical recovery status, this skill ensures your agent has real-time access to the most vital components of your personal health data.

Installation

Getting started requires a few simple steps. First, install the necessary Python dependencies via the provided requirements file. Execute the OAuth authentication script once, passing your Garmin credentials to generate a secure session token stored locally at ~/.garth/session.json. Once authenticated, verify the functionality by running the sync script. To ensure your data remains current, add the provided shell script to your system crontab, setting it to execute every five minutes. This enables background data refreshes without manual intervention. For advanced users, the cache path can be modified via command-line arguments to suit custom file directory structures.

Use Cases

• Automated Health Monitoring: Receive automated daily briefings from your agent summarizing your sleep quality and step count progress.
• Performance Analysis: Ask the AI to identify trends in your heart rate recovery or workout intensity across specific weeks.
• Lifestyle Optimization: Allow the agent to suggest optimal workout times based on your sleep score and recovery metrics retrieved from your Garmin device.

Example Prompts

1. "How did my sleep quality look last night, and did I hit my step goal for today?"
2. "Summarize my recent workout performance for this week and calculate my average calories burned per activity."
3. "Check my resting heart rate trend over the last few days and let me know if I am trending towards recovery or fatigue."

Tips & Limitations

To maintain security, ensure your session tokens are never shared or committed to public repositories. The data is cached locally for rapid agent access, which minimizes API calls to Garmin servers. Note that initial authentication is required only once, but persistent network access is necessary for the cron jobs to successfully fetch updates. Ensure that your Garmin account is active and syncing with the Garmin Connect mobile app for the most accurate data availability.