garmin

Files (1)

• SKILL.md

SKILL.md (first lines)

# Garmin Connect Skill

Query Garmin Connect health data by writing UV inline Python scripts using garminconnect.

## Setup

### Credentials

Requires `GARMIN_EMAIL` and `GARMIN_PASSWORD` in `workspace/.env`.

If not set, ask the user for their Garmin email and password, then append to `.env`:

```bash
echo 'GARMIN_EMAIL=their_email' >> .env
echo 'GARMIN_PASSWORD=their_password' >> .env
```

Consider using app-specific passwords if the user has 2FA enabled.

### Authentication

Once credentials are in `.env`, authenticate and save the session:

```bash
set -a; source .env 2>/dev/null; set +a; uv run - <<'EOF'
# /// script
# requires-python = ">=3.11"
# dependencies = ["garminconnect>=0.2.38"]
# ///
import os
from pathlib import Path
from garminconnect import Garmin

client = Garmin(os.environ["GARMIN_EMAIL"], os.environ["GARMIN_PASSWORD"], return_on_mfa=True)
result1, result2 = client.login()

if result1 == "needs_mfa":
    print("MFA_REQUIRED")
else:
    client.garth.dump("garmin-session")
    Path("garmin-session").chmod(0o700)
    print(f"SUCCESS: Logged in as {client.get_full_name()}")
EOF
```

If the output contains `MFA_REQUIRED`, ask the user for their MFA code, then run:

```bash
set -a; source .env 2>/dev/null; set +a; uv run - MFA_CODE_HERE <<'EOF'
# /// script
# requires-python = ">=3.11"
# dependencies = ["garminconnect>=0.2.38"]
# ///
import os, sys
from pathlib import Path
from garminconnect import Garmin

client = Garmin(os.environ["GARMIN_EMAIL"], os.environ["GARMIN_PASSWORD"], return_on_mfa=True)
result1, result2 = client.login()
client.resume_login(result2, sys.argv[1])

client.garth.dump("garmin-session")
Path("garmin-session").chmod(0o700)
print(f"SUCCESS: Logged in as {client.get_full_name()}")
EOF
```

Session is saved to `workspace/garmin-session/` and lasts ~1 year.

## Query Template

```bash
set -a; source .env 2>/dev/null; set +a; uv run - <<'EOF'
# /// script
# requires-python = ">=3.11"
# dependencies = ["garminconnect>=0.2.38"]
# ///
from datetime import date, timedelta
from pathlib import Path
from garminconnect import Garmin

TOKEN_DIR = Path("garmin-session")
if not TOKEN_DIR.exists():
    print("ERROR: Not authenticated — run Garmin setup first")
    exit(1)

client = Garmin()
client.login(str(TOKEN_DIR))

today = date.today().isoformat()

# === YOUR QUERY CODE HERE ===
stats = client.get_stats(today)
print(f"Steps: {stats.get('totalSteps', 0):,}")
EOF
```

## API Reference

### Health Methods

| Method                         | Description                                           |
| ------------------------------ | ----------------------------------------------------- |
| `get_stats(date)`              | Daily summary (steps, calories, HR, stress durations) |
| `get_sleep_data(date)`         | Sleep stages and scores                               |
| `get_heart_rates(date)`        | Heart rate summary                                    |
| `get_hrv_data(date)`           | Heart rate variability                                |
| `get_stress_data(date)`        | Stress levels (avg/max only, durations in get_stats)  |
| `get_body_battery(start, end)` | Body battery readings                                 |

### Activity Methods

| Method                               | Description               |
| ------------------------------------ | ------------------------- |
| `get_activities(start, limit)`       | List recent activities    |
| `get_activities_by_date(start, end)` | Activities in date range  |
| `get_activity(id)`                   | Single activity details   |
| `get_training_status(date)`          | Training load and VO2 max |

From eddmann/jeeves, MIT.

More from eddmann/jeeves