A command-line interface designed to fetch health, sleep, and activity metrics from the Oura Ring V2 API for AI agent consumption.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install oura
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install oura using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Oura Ring CLI Skill?
The Oura Ring CLI Skill provides a robust interface for accessing personal health and biometric data directly from the Oura Ring API (V2). As part of the growing ecosystem of Openclaw Skills, this tool enables developers and AI agents to query complex physiological datasets—such as sleep stages, heart rate variability, and readiness scores—using simple terminal commands.
By leveraging this skill, users can transform their wearable data into actionable insights within their automated workflows. The integration handles the complexities of the Oura OAuth flow and data parsing, making it an essential component for anyone looking to build personalized health assistants or research tools using Openclaw Skills.
Oura Ring CLI Skill Use Cases
- Tracking daily sleep quality and recovery metrics through natural language queries.
- Monitoring cardiovascular health trends including heart rate, VO2 Max, and cardiovascular age.
- Analyzing activity levels, step counts, and workout intensity for fitness coaching.
- Correlating lifestyle tags and notes with physiological stress and resilience levels.
- Retrieving detailed hypnogram data for advanced sleep analysis and optimization.
How Oura Ring CLI Skill Works
- The user or agent initiates a request for specific health data (e.g., "How was my sleep?").
- The skill resolves relative timeframes like "last night" or "this week" into absolute ISO-8601 dates.
- A command is constructed using the
oura get <category>syntax with appropriate date flags. - The CLI communicates with the Oura API V2 using authenticated OAuth tokens stored in the local config.
- The tool receives structured JSON data, which is then parsed by the agent to provide a human-readable summary.
Oura Ring CLI Skill Setup
First, build the CLI tool from the source repository:
cd ~
git clone https://github.com/ruhrpotter/oura-cli.git
cd oura-cli
go build -o oura ./cmd/oura
Next, configure your credentials by creating an application in the Oura Developer Portal and setting the redirect URI to http://localhost:8080/callback. Authenticate your session using:
export OURA_CLIENT_ID="your_client_id"
export OURA_CLIENT_SECRET="your_client_secret"
./oura auth login
Tokens will be securely stored in ~/.config/oura-cli/config.json for future Openclaw Skills sessions.
Oura Ring CLI Skill Data Schema & Taxonomy
The skill organizes health data into specific categories, returning detailed JSON arrays that include:
| Category | Description | Key Metrics |
|---|---|---|
sleep |
Daily sleep performance | Score, efficiency, REM, deep sleep duration |
readiness |
Recovery status | HRV balance, recovery index, body temperature |
activity |
Physical movement | Steps, active calories, metabolic equivalents (METs) |
heartrate |
Physiological snapshots | Beats per minute (BPM) time-series |
stress |
Daily stress tracking | Stress levels and resilience markers |
personal |
User profile | Age, weight, height, and hardware configuration |
Oura Ring CLI Skill Advanced Features
- Intelligent date resolution that automatically converts human-relative terms into required API date formats.
- Support for high-resolution time-series data including heart rate and SpO2 levels.
- Access to advanced recovery metrics like Cardiovascular Age and VO2 Max.
- Capability to fetch granular sleep-details including hypnogram and movement data.
- Seamless integration with lifestyle tags to track the impact of specific habits on health data within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Apple App Store Connect Release Flow (ASC)
An automated workflow for deploying iOS applications to TestFlight and the App Store using the App Store Connect CLI.
SatsRail MCP: Bitcoin Lightning Payments
Enable AI agents to accept Bitcoin Lightning payments, generate invoices, and handle microtransactions via natural language.
PCO CLI - Planning Center Services
A robust command-line interface for Planning Center Services that streamlines church service planning and team scheduling through the Openclaw Skills framework.
Clawdgle
A specialized markdown-first search engine API designed for AI agents to find, retrieve, and index web content as clean markdown.
Beeminder Goal Tracker
A streamlined integration for managing Beeminder commitment devices and habit tracking through direct REST API access.
ffcli: Fireflies.ai CLI Integration
A command-line interface for Fireflies.ai that enables AI agents to retrieve meeting transcripts, summaries, and action items programmatically.
METADATA
Featured*
