u/drakulavich

Hey everyone,

If you've ever wished you could just talk to your Oura data — "hey, what's been killing my readiness lately?" — oura-cli is built to plug into AI agents 🤖 like OpenClaw 🦞 and Hermes as a tool they can call. The agent runs the CLI, reads your real numbers from the local database, and answers in plain English. Like giving your AI assistant read-only access to your health data, all on your own machine.

oura-cli → https://github.com/drakulavich/oura-cli

Chatting with OpenClaw about Oura data

What it does

• Pulls sleep, readiness, activity, heart rate, SpO₂, stress, and workouts from the official Oura V2 API
• Caches everything into a local SQLite DB at ~/.oura-cli/oura.db so reports keep working offline
• Pretty tables in the terminal, auto-switches to stable JSON the moment you pipe it
• Generates weekly / monthly digests with averages, trend deltas vs the previous window, and short "you slept poorly Tuesday" callouts

First five minutes

bun add -g u/drakulavich/oura-cli
oura-cli login         # paste your Personal Access Token, one time
oura-cli sync          # backfill recent days into local cache
oura-cli report        # weekly digest in the terminal
oura-cli db today      # today's scores from cache

The boring but important bits

• You need a free Personal Access Token from https://cloud.ouraring.com/personal-access-tokens
• Works on macOS, Linux, Windows (WSL)
• It's brand new and rough around the edges — issues and PRs very welcome

Bonus for the agent crowd: there's an oura-cli describe command that emits a JSON manifest of every command and output schema, so LLM harnesses / MCP-style tools can discover capabilities without scraping --help. A first-party MCP companion is on the roadmap.

Would love to hear what reports or integrations would be useful — happy to prioritize whatever the community actually wants.