An AI-driven experience management platform for enterprises to collect multi-channel feedback, analyze structured and unstructured data, and deliver actionable insights.
ouracli
FreeStarting price
0Popularity
About ouracli
ouracli provides a command-line interface and Model Context Protocol server for the Oura Ring API v2. It exposes sleep, readiness, heart rate variability, workouts, and other health metrics through a set of typed commands and a live schema manifest. The tool is designed to integrate directly with AI agents like Claude or Codex, enabling them to query and analyze personal health data without exposing credentials. Commands follow a consistent verb-based structure (e.g., oura sleep, oura readiness) and support filtering by date ranges, field selection, and pagination. The project includes a zero-credential sandbox mode that mirrors the real API’s JSON structure for testing. All tokens are stored in the operating system’s keychain or an encrypted file, ensuring they remain outside the agent’s context. The CLI and MCP server share a single registry to maintain consistency across tools.
Key features
- CLI commands for 18+ Oura data types (sleep, readiness, HRV, workouts, etc.)
- MCP server integration for AI agents (Claude, Codex)
- Sandbox mode with fake data for testing
- Date range filtering (--start, --end)
- Field selection (--fields) and pagination (--all)
- Consistent JSON output format across all commands
- OS keychain or encrypted file for credential storage
- Live schema manifest for tool discovery
Use cases
- Querying personal sleep metrics and trends over time
- Analyzing readiness scores alongside HRV for recovery insights
- Integrating Oura data into AI-driven health coaching or analysis
Pros
- Full coverage of Oura API v2 endpoints including resilience, cardiovascular age, VO2 max, SpO2, and stress
- Agent-first design with typed errors, exit codes, and a live schema manifest for reliable automation
- Zero-credential sandbox mode for testing without an Oura account
- Tokens stored in OS keychain or encrypted file, never exposed to the agent
- Single binary with no runtime dependencies
Cons
- Unofficial project not affiliated with Oura Health Oy
- Requires Homebrew or Go installation for setup
- Limited to Oura Ring data; no support for other wearables
Frequently asked questions about ouracli
What is ouracli and what does it do?
ouracli is a command-line interface and Model Context Protocol (MCP) server for the Oura Ring API v2. It provides typed commands to access sleep, readiness, heart rate variability, workouts, and other health metrics, enabling AI agents like Claude or Codex to query and analyze personal health data securely.
Who is ouracli designed for?
ouracli is designed for users who want to integrate their Oura Ring data with AI agents for health insights. It is particularly useful for individuals comfortable with command-line tools and those seeking to automate health data analysis without exposing credentials.
How does ouracli handle authentication and security?
ouracli stores tokens in the operating system’s keychain or an encrypted file, ensuring they remain outside the AI agent’s context. It also offers a zero-credential sandbox mode for testing without exposing real data.
Can ouracli work without an Oura Ring?
Yes, ouracli includes a sandbox mode that mimics the real API’s JSON structure using fake data, allowing users to explore the tool’s capabilities without connecting a physical Oura Ring.
What are the main commands available in ouracli?
ouracli offers commands like `oura sleep`, `oura readiness`, `oura heartrate`, `oura workouts`, and `oura resilience`, among others. Each command follows a consistent verb-based structure and supports filtering by date ranges, field selection, and pagination.
How do I get started with ouracli?
To get started, install the CLI via Homebrew or Go, then register it as an MCP server in your AI agent (e.g., Claude or Codex). Connect your Oura Ring using `oura auth login` or explore the sandbox mode first for credential-free testing.
