Garmin Health & Fitness

Query Garmin Connect for health metrics, sleep data, activities, and training status. Supports live queries and periodic markdown imports.

Prerequisites

• Python virtual environment set up (run setup.sh if not done)
• Garmin Connect credentials configured

First-Time Setup

~/.claude/skills/garmin/scripts/setup.sh

On-Demand Queries

Today's Vitals

~/.claude/skills/garmin/.venv/bin/python ~/.claude/skills/garmin/scripts/garmin_health.py today

Returns: Resting HR, HRV, Body Battery, stress, steps, calories.

Health for a Specific Date

~/.claude/skills/garmin/.venv/bin/python ~/.claude/skills/garmin/scripts/garmin_health.py 2026-02-22
~/.claude/skills/garmin/.venv/bin/python ~/.claude/skills/garmin/scripts/garmin_health.py yesterday

Weekly Vitals Summary

~/.claude/skills/garmin/.venv/bin/python ~/.claude/skills/garmin/scripts/garmin_health.py week

Returns: 7-day table of all vitals with averages.

Sleep Data

# Last night
~/.claude/skills/garmin/.venv/bin/python ~/.claude/skills/garmin/scripts/garmin_sleep.py

# Specific date
~/.claude/skills/garmin/.venv/bin/python ~/.claude/skills/garmin/scripts/garmin_sleep.py 2026-02-22

Returns: Sleep score, duration, deep/light/REM/awake breakdown.

Recent Activities

# Last 7 days
~/.claude/skills/garmin/.venv/bin/python ~/.claude/skills/garmin/scripts/garmin_activities.py 7

# Last 30 days
~/.claude/skills/garmin/.venv/bin/python ~/.claude/skills/garmin/scripts/garmin_activities.py 30

Returns: Activity list with HR, calories, training effect.

Training Status

~/.claude/skills/garmin/.venv/bin/python ~/.claude/skills/garmin/scripts/garmin_activities.py training

Returns: VO2 max, training load, training readiness, training status.

Periodic Imports

Daily Snapshot

Pulls all data for a day and writes to a markdown file:

# Today (output dir is required)
~/.claude/skills/garmin/.venv/bin/python ~/.claude/skills/garmin/scripts/garmin_snapshot.py --output-dir /path/to/health/garmin

# Specific date
~/.claude/skills/garmin/.venv/bin/python ~/.claude/skills/garmin/scripts/garmin_snapshot.py --output-dir /path/to/health/garmin 2026-02-22

# Yesterday
~/.claude/skills/garmin/.venv/bin/python ~/.claude/skills/garmin/scripts/garmin_snapshot.py --output-dir /path/to/health/garmin yesterday

Output: <output-dir>/YYYY-MM-DD.md

Weekly Rollup

Aggregates a week of data into a weekly summary markdown file:

# Current week
~/.claude/skills/garmin/.venv/bin/python ~/.claude/skills/garmin/scripts/garmin_rollup.py --output-dir /path/to/health/garmin/weekly

# Last week
~/.claude/skills/garmin/.venv/bin/python ~/.claude/skills/garmin/scripts/garmin_rollup.py --output-dir /path/to/health/garmin/weekly last

# Specific week
~/.claude/skills/garmin/.venv/bin/python ~/.claude/skills/garmin/scripts/garmin_rollup.py --output-dir /path/to/health/garmin/weekly 2026-W08

Output: <output-dir>/YYYY-WXX.md

Workflows

Daily Review

1. Run snapshot to capture today's data
2. Reference key metrics in the daily review
3. Note any anomalies or patterns

Weekly Review

1. Run rollup for the week
2. Compare trends against previous weeks
3. Cross-reference with other health data
4. Add context notes to the rollup file

Quick Health Check

Ask: "What's my body battery?", "How did I sleep?", "Show my training status" Claude runs the relevant on-demand query and returns formatted results.

Error Handling

• Auth expired: Auto-refreshes using stored credentials
• Wrong credentials: Clear error, suggests re-running setup.sh
• No data for date: Sections show "No data" rather than failing
• Garmin service down: 30s timeout with clear error
• MFA required: Interactive prompt (first login only)

Test Auth

~/.claude/skills/garmin/.venv/bin/python ~/.claude/skills/garmin/scripts/garmin_client.py