garmin-health-analysis
Talk to your Garmin data naturally - "what was my fastest speed snowboarding?", "how did I sleep last night?", "what was my heart rate at 3pm?". Access 20+ metrics (sleep stages, Body Battery, HRV, VO2 max, training readiness, body composition, SPO2), download FIT/GPX files for route analysis, query elevation/pace at any point, and generate interactive health dashboards. From casual "show me this week's workouts" to deep "analyze my recovery vs training load".
Why use this skill?
Analyze your Garmin health data, track sleep, HRV, and workouts, and generate interactive health dashboards directly within OpenClaw. Easy setup for deep fitness insights.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/eversonl/garmin-health-analysisWhat This Skill Does
The garmin-health-analysis skill transforms OpenClaw into a personal health data scientist. By interfacing directly with the Garmin Connect API, this skill allows users to retrieve granular health and fitness metrics without navigating complex web dashboards. It supports fetching over 20 distinct metrics, including sleep stages, Body Battery, HRV, VO2 max, training readiness, and blood oxygen levels (SPO2). Beyond simple data retrieval, it provides capabilities for downloading activity files (FIT/GPX) and generates interactive health dashboards, making it easier to correlate recovery metrics like HRV with training load over time.
Installation
Installation follows a standard OpenClaw workflow. First, install the necessary dependencies via pip3 install garminconnect. You then have three primary configuration paths for your credentials: using the Clawdbot environment variables in your ~/.clawdbot/clawdbot.json, creating a local config.json within the skill directory, or passing credentials via the command line. After configuration, you must run python3 scripts/garmin_auth.py login to authenticate and store session tokens securely in ~/.clawdbot/garmin-tokens.json. These tokens are designed to auto-refresh, ensuring persistent access to your health data. You can always verify your connectivity by running the status check command.
Use Cases
- Recovery Analysis: Evaluate your Body Battery and HRV trends over the last 30 days to determine if your body is adequately recovered for high-intensity training.
- Performance Review: Download GPX/FIT files from specific workouts to analyze elevation gain, pace, and heart rate zones during specific segments of a run or ride.
- Sleep Optimization: Extract sleep stage data to understand your deep vs. light sleep patterns and identify external factors affecting rest quality.
- Training Load Monitoring: Summarize weekly activity data to ensure your volume aligns with your long-term fitness goals.
Example Prompts
- "What was my fastest speed snowboarding during my trip last weekend?"
- "How did my HRV trend look last week compared to my training load?"
- "Show me a summary of my sleep stages and Body Battery levels for the past 14 days."
Tips & Limitations
- Data Granularity: While the skill can pull raw data, complex multi-variable analysis is best performed by asking the AI to interpret the fetched JSON summary.
- Privacy: Your credentials and session tokens are stored locally; ensure your machine is encrypted and secure.
- Rate Limiting: Frequent polling of the Garmin API may lead to temporary blocks; stick to reasonable request intervals for your dashboards.
- Setup: Always prioritize the Clawdbot UI environment variable method for a seamless experience.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-eversonl-garmin-health-analysis": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-read, file-write, external-api