garmin-connect-pro

# Garmin Connect Pro

The most comprehensive Garmin Connect skill for OpenClaw. Retrieve activities, health data, sleep analysis, heart rate, stress, body battery, training readiness, VO2 max, and more from your Fenix, Forerunner, Index scales, or other Garmin devices.

## Security & Privacy

⚠️ **Important Security Information:**

### Credential Options

**Option 1: Environment Variables (Recommended for cron jobs)**
```bash
export GARMIN_EMAIL="your-email@example.com"
export GARMIN_PASSWORD="your-password"
```
- More secure for automated/scheduled usage
- Not stored on disk
- Works with cron jobs without leaving plaintext files

**Option 2: Credentials File**
```bash
mkdir -p ~/.config/garmin-connect
echo '{"email": "your-email@example.com", "password": "your-password"}' > ~/.config/garmin-connect/credentials.json
chmod 600 ~/.config/garmin-connect/credentials.json
```
- Stored in plaintext (any process with file access can read it)
- File permissions set to 600 (owner read/write only)
- Consider excluding from backups

### Third-Party Library

This skill uses the `garminconnect` Python library for all Garmin API communication. 
- **Source code:** https://github.com/cyberjunkie/garminconnect
- **Trust boundary:** All API calls go through this library
- **Recommendation:** Audit the library if you have strict security requirements

### Data Flow

```
Your Credentials → garminconnect library → Garmin API servers
                     ↓
              OAuth tokens cached locally
```

No data is transmitted to any third parties other than Garmin via the official garminconnect library.

## Setup

### First-time Login

```bash
# Install dependency
pip3 install garminconnect

# Option A: Use environment variables (recommended)
export GARMIN_EMAIL="your-email@example.com"
export GARMIN_PASSWORD="your-password"

# Option B: Use credentials file
mkdir -p ~/.config/garmin-connect
echo '{"email": "your-email@example.com", "password": "your-password"}' > ~/.config/garmin-connect...

# Garmin Connect Pro

> Want to be fit like @steipete? Well, now you can track every step of your journey—literally.

**The most comprehensive Garmin Connect skill for OpenClaw.** Retrieve activities, health data, sleep analysis, heart rate, stress, body battery, training readiness, VO2 max, and more from your Fenix, Forerunner, Index scales, or other Garmin devices.

## Security & Privacy

⚠️ **Important Security Information:**

### Credential Options

**Option 1: Environment Variables (Recommended for cron jobs)**
```bash
export GARMIN_EMAIL="your-email@example.com"
export GARMIN_PASSWORD="your-password"
```
- More secure for automated/scheduled usage
- Not stored on disk
- Works with cron jobs without leaving plaintext files

**Option 2: Credentials File**
```bash
mkdir -p ~/.config/garmin-connect
echo '{"email": "your-email@example.com", "password": "your-password"}' > ~/.config/garmin-connect/credentials.json
chmod 600 ~/.config/garmin-connect/credentials.json
```
- Stored in plaintext (any process with file access can read it)
- File permissions set to 600 (owner read/write only)
- Consider excluding from backups

### Third-Party Library

This skill uses the `garminconnect` Python library for all Garmin API communication. 
- **Source code:** https://github.com/cyberjunkie/garminconnect
- **Trust boundary:** All API calls go through this library
- **Recommendation:** Audit the library if you have strict security requirements

### Data Flow

```
Your Credentials → garminconnect library → Garmin API servers
                     ↓
              OAuth tokens cached locally
```

No data is transmitted to any third parties other than Garmin via the official garminconnect library.

## What makes this different

| Feature | Garmin Connect Pro | Others |
|---------|-------------------|--------|
| **Natural Language Queries** | ✅ "how did I sleep?" | ❌ |
| **ASCII Charts** | ✅ Built-in | ❌ |
| **Week-over-Week Comparison** | ✅ | ❌ |
| **Race Predictions** | ✅ 5K t...