Oura

What This Skill Does

The Oura Ring CLI skill, developed by ruhrpotter, serves as a powerful bridge between OpenClaw and your biometric data stored within the Oura Cloud platform. By leveraging the Oura API (V2), this tool allows the AI agent to pull health, sleep, activity, and readiness metrics directly from your Oura ring. It acts as an interface that retrieves structured data—such as heart rate, sleep scores, VO2 Max, and cardiovascular age—and transforms it into actionable insights. Whether you are tracking daily trends or looking for specific physiological data, this skill provides a secure, command-line-driven method to access your wellness metrics without leaving your terminal environment.

Installation

To begin, ensure you have Go installed on your system. First, clone the repository from GitHub: git clone https://github.com/ruhrpotter/oura-cli.git. Once cloned, navigate into the directory and run go build -o oura ./cmd/oura to compile the binary. You must then register an application on the Oura Developer Portal to receive your OAuth credentials. Set your redirect URI to http://localhost:8080/callback. After gathering your Client ID and Client Secret, execute ./oura auth login while exporting these credentials as environment variables. This creates a secure token stored in ~/.config/oura-cli/config.json.

Use Cases

This skill is ideal for personal health tracking, fitness analysis, and productivity optimization. Users can query their readiness scores to determine if they should push hard at the gym or opt for a rest day. You can track daily steps and activity to meet movement goals, or analyze sleep-details to identify patterns affecting your energy levels. Furthermore, it is excellent for longitudinal data analysis, allowing you to see how lifestyle tags—such as late meals or exercise—correlate with your recovery metrics over a week or month.

Example Prompts

1. "How did my sleep quality and readiness score look yesterday?"
2. "Get my activity and step count for the last 7 days and summarize my movement trends."
3. "What is my current VO2 Max and how does it compare to my cardiovascular age?"

Tips & Limitations

Always ensure your date strings are formatted as YYYY-MM-DD for accurate API querying. If the CLI fails to return data, check your authentication status by running the login command again. Note that some endpoints require historical windows; for these, always use the --start flag to specify the beginning of your data range. The skill parses raw JSON output, so complex data points are best handled by letting the AI summarize the trends rather than reading raw numbers.