Garmin Health Analysis

Query health metrics from Garmin Connect and generate interactive HTML charts.

Two Installation Paths

This skill supports two different setups:

1. 1. Clawdbot Skill (this guide) - Use with Clawdbot for automation and proactive health monitoring
2. MCP Server (see MCP setup guide) - Use with standard Claude Desktop as an MCP server

Choose the path that matches your use case. You can also use both simultaneously!

Clawdbot Skill Setup (first time only)

1. Install Dependencies

CODEBLOCK0

2. Configure Credentials

You have three options to provide your Garmin Connect credentials:

Option A: Clawdbot Config (Recommended - UI configurable)

Add credentials to ~/.clawdbot/clawdbot.json:

CODEBLOCK1

Tip: You can also set these through the Clawdbot UI in the Skills settings panel.

Option B: Local Config File

Create a config file in the skill directory:

CODEBLOCK2

config.json:
CODEBLOCK3

Note: config.json is gitignored to keep your credentials secure.

Option C: Command Line

Pass credentials directly when authenticating:
CODEBLOCK4

3. Authenticate

Login to Garmin Connect and save session tokens:

CODEBLOCK5

This uses credentials from (in priority order):

1. 1. Command line arguments (--email, --password)
2. Local config file (config.json)
3. Environment variables (GARMIN_EMAIL, GARMIN_PASSWORD)
4. Clawdbot config (skills.entries.garmin-health-analysis.env)

Session tokens are stored in ~/.clawdbot/garmin-tokens.json and auto-refresh.

Check authentication status:
CODEBLOCK6

Fetching Data

Use scripts/garmin_data.py to get JSON data:

CODEBLOCK7

Output is JSON to stdout. Parse it to answer user questions.

Generating Charts

Use scripts/garmin_chart.py for interactive HTML visualizations:

CODEBLOCK8

Charts open automatically in the default browser. They use Chart.js with a modern gradient design, stat cards, and interactive tooltips.

Answering Questions

Key Metrics

Body Battery (0-100)

• - High (75-100): Fully recharged, ready for high intensity
• Medium (50-74): Moderate energy, good for regular activity
• Low (25-49): Limited energy, recovery needed
• Very Low (0-24): Depleted, prioritize rest

Sleep Scores (0-100)

• - Excellent (90-100): Optimal restorative sleep
• Good (80-89): Quality sleep with minor issues
• Fair (60-79): Adequate but could improve
• Poor (0-59): Significant sleep deficiencies

HRV (Heart Rate Variability)

• - Indicates nervous system balance and recovery capacity
• Track trends over time (increasing = improving recovery)
• Affected by sleep, stress, training load, illness
• Normal range varies by individual (20-200+ ms)

Resting Heart Rate (bpm)

• - Athletes: 40-60 bpm
• Fit adults: 60-70 bpm
• Average adults: 70-80 bpm
• Sudden increases may indicate stress, illness, or overtraining

Stress Levels

• - Low stress: Rest and recovery periods
• Medium stress: Normal daily activities
• High stress: Physical activity or mental pressure

Health Analysis

When users ask for insights or want to understand their trends, use references/health_analysis.md for:

• - Science-backed interpretation of all metrics
• Normal ranges by age and fitness level
• Pattern detection (weekly trends, recovery cycles, training load balance)
• Actionable recommendations based on data
• Warning signs that suggest rest or medical consultation

Analysis workflow

1. 1. Fetch data: INLINECODE18
2. Read references/health_analysis.md for interpretation framework
3. Apply the analysis framework: Status → Trends → Patterns → Insights → Recommendations
4. Always include disclaimer that this is informational, not medical advice

Troubleshooting

Authentication Issues

• - "Invalid credentials": Double-check email/password, try logging into Garmin Connect web
• "Tokens expired": Run login again: INLINECODE20
• "Too many requests": Garmin rate-limits; wait a few minutes and try again

Missing Data

• - Some metrics require specific Garmin devices (Body Battery needs HRV-capable devices)
• Historical data may have gaps if device wasn't worn
• New accounts may have limited history

Library Issues

• - If garminconnect import fails: INLINECODE22
• Garmin occasionally changes their API; update the library if requests fail

Privacy Note

• - Credentials are stored locally in INLINECODE23
• Session tokens refresh automatically
• No data is sent anywhere except to Garmin's official servers
• You can revoke access anytime by deleting the tokens file

Comparison: Garmin vs Whoop

References

• - references/api.md — Garmin Connect API details (unofficial)
• INLINECODE25 — Science-backed health data interpretation
• garminconnect library — Python API wrapper
• Garmin Connect — Official web interface

Version Info

• - Created: 2026-01-25
• Author: EversonL & Claude
• Version: 1.2.0
• Dependencies: garminconnect, fitparse, gpxpy (Python libraries)
• License: MIT