Syncs daily health and fitness data from Oura Ring into markdown files. Provides sleep, readiness, activity, heart rate, stress, SpO2, and workout data.
---
name: oura-ring
description: Syncs daily health and fitness data from Oura Ring into markdown files. Provides sleep, readiness, activity, heart rate, stress, SpO2, and workout data.
disable-model-invocation: true
metadata:
openclaw:
primaryEnv: OURA_TOKEN
requires:
bins: ["uv"]
env: ["OURA_TOKEN"]
config:
- id: oura_token
label: Oura Personal Access Token
type: secret
env: OURA_TOKEN
---
# Oura Ring
This skill syncs your daily health data from Oura Ring into readable markdown files.
## Syncing Data
Sync today's data:
```bash
uv run {baseDir}/scripts/sync_oura.py
```
Sync a specific date:
```bash
uv run {baseDir}/scripts/sync_oura.py --date 2026-02-07
```
Sync the last N days:
```bash
uv run {baseDir}/scripts/sync_oura.py --days 7
```
## Reading Health Data
Health files are stored at `{baseDir}/health/YYYY-MM-DD.md` — one file per day.
To answer health or fitness questions, read the relevant date's file from the `{baseDir}/health/` directory. If the file doesn't exist for the requested date, run the sync command for that date first.
## Cron Setup
Schedule the sync script to run every morning using OpenClaw's `cron` tool so your health data stays up to date automatically.
don't have the plugin yet? install it then click "run inline in claude" again.