garminlisted
Install: claude install-skill dbhq-uk/garmin-skill
# 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
```bash
${CLAUDE_SKILL_DIR}/scripts/setup.sh
```
## Re-Login (Token Refresh)
If authentication fails (expired tokens, rate limits), re-login:
```bash
${CLAUDE_SKILL_DIR}/.venv/bin/python ${CLAUDE_SKILL_DIR}/scripts/garmin_login.py
```
Supports MFA interactively or via argument (`garmin_login.py 123456`).
When run non-interactively, writes MFA code path to `/tmp/garmin_mfa.txt`.
## On-Demand Queries
### Today's Vitals
```bash
${CLAUDE_SKILL_DIR}/.venv/bin/python ${CLAUDE_SKILL_DIR}/scripts/garmin_health.py today
```
Returns: Resting HR, HRV, Body Battery, stress, steps, calories.
### Health for a Specific Date
```bash
${CLAUDE_SKILL_DIR}/.venv/bin/python ${CLAUDE_SKILL_DIR}/scripts/garmin_health.py 2026-02-22
${CLAUDE_SKILL_DIR}/.venv/bin/python ${CLAUDE_SKILL_DIR}/scripts/garmin_health.py yesterday
```
### Weekly Vitals Summary
```bash
${CLAUDE_SKILL_DIR}/.venv/bin/python ${CLAUDE_SKILL_DIR}/scripts/garmin_health.py week
```
Returns: 7-day table of all vitals with averages.
### Sleep Data
```bash
# Last night
${CLAUDE_SKILL_DIR}/.venv/bin/python ${CLAUDE_SKILL_DIR}/scripts/garmin_sleep.py
# Specific date
${CLAUDE_SKILL_DIR}/.venv/bin/python ${CLAUDE_SKILL