← Back to Skills Marketplace
879
Downloads
2
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install oura-cli
Description
Retrieve health and biometric data from your Oura Ring via CLI commands for sleep, activity, readiness, heart rate, and more using specified dates.
Usage Guidance
What to consider before installing or running this skill:
- The bundled code is a normal Oura CLI: it uses OAuth and will store your Client ID/Secret and tokens in ~/.config/oura-cli/config.json. If you run it, expect local persistent storage of credentials and tokens.
- The registry metadata omitted required env vars and an install/build step. Before running any binary, either build the included source locally (go build ./cmd/oura) or inspect the code yourself. Do not run an unreviewed prebuilt binary.
- The auth flow starts a temporary HTTP server on localhost:8080 to receive the OAuth callback; that can interfere with existing services using that port. If you do authentication, prefer creating a dedicated Oura app with minimal scopes and revoke the app afterwards if you don't trust it.
- If you only want agent-driven answers (without giving real credentials), avoid providing your production Oura client secret. Consider testing with a throwaway account or running the CLI in an isolated environment (container or VM).
- The mismatches (no declared env vars, no install steps) are likely sloppy metadata rather than malicious intent, but they reduce transparency. If you plan to use this skill, inspect the source files provided and confirm you are comfortable with the local config behavior and OAuth scopes before proceeding.
Capability Analysis
Type: OpenClaw Skill
Name: oura-cli
Version: 1.0.0
The skill is classified as suspicious due to a vulnerability in how OAuth tokens are stored. The `internal/config/config.go` file uses `os.Create` to save `config.json`, which by default creates files with world-readable permissions (e.g., 0644 on most systems after umask). This allows other local users on the same system to read the `AccessToken` and `RefreshToken`, potentially leading to unauthorized access to the user's Oura data. While the core functionality is benign and the prompt injection instructions in `SKILL.md` are for legitimate tool usage, this information disclosure vulnerability is a significant security flaw.
Capability Assessment
Purpose & Capability
The code and SKILL.md implement an Oura Ring CLI that queries the Oura V2 API and returns JSON — this matches the expected purpose. There are no unrelated network endpoints or unrelated credentials requested in the source. Functionality (sleep, activity, readiness, heartrate, etc.) aligns with the stated capability.
Instruction Scope
The SKILL.md instructs the agent to run a local binary (./oura) and to resolve dates and parse JSON responses — that stays within the Oura-CLI purpose. However, invoking the CLI will read/write the user's config at the standard config directory (~/.config/oura-cli/config.json) and the auth flow starts a local HTTP server on port 8080 to receive OAuth callbacks. The SKILL.md does not explicitly mention the local server or persistent config file behavior, which is relevant runtime scope.
Install Mechanism
No install spec is provided in the registry (instruction-only), but full Go source files are bundled and the README documents a 'go build' workflow. The SKILL.md assumes a built ./oura binary is present; the absence of an install/build step in metadata is a mismatch but not inherently malicious. Risk is low provided you build/review the included source yourself; running pre-built binaries without inspection would be higher risk.
Credentials
Registry metadata declares no required environment variables, but the code and README legitimately use OURA_CLIENT_ID and OURA_CLIENT_SECRET (and may read them from env or prompt). The tool also stores OAuth tokens and secrets in the user's config directory (~/.config/oura-cli/config.json). The omission of these env requirements and the config path from metadata is an inconsistency that affects sensitive data handling and should be disclosed to users.
Persistence & Privilege
The skill does not request always:true and does not modify other skills or system-wide settings. It does persist its own config (client id/secret, access/refresh tokens) under the user's config directory, and its auth flow opens a local HTTP listener on port 8080 during login — both are normal for an OAuth CLI but worth noting as side effects.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install oura-cli - After installation, invoke the skill by name or use
/oura-cli - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Adds CLI integration for Oura Ring biometric data access and querying.
- Enables retrieval of sleep, activity, readiness, heart rate, and more from the Oura API v2 via command-line.
- Supports flexible date range arguments with absolute date resolution for user-friendly queries.
- Returns JSON data, which should be parsed and summarized in natural language.
- Includes extensive data category support (e.g., sleep-details, workout, vo2-max, stress, resilience).
- Notifies users about authentication requirements on auth errors.
- Provides clear usage examples for common queries.
Metadata
Frequently Asked Questions
What is Oura Cli?
Retrieve health and biometric data from your Oura Ring via CLI commands for sleep, activity, readiness, heart rate, and more using specified dates. It is an AI Agent Skill for Claude Code / OpenClaw, with 879 downloads so far.
How do I install Oura Cli?
Run "/install oura-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Oura Cli free?
Yes, Oura Cli is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Oura Cli support?
Oura Cli is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Oura Cli?
It is built and maintained by Danielle (@supadoopa); the current version is v1.0.0.
More Skills