ouracli
Ask your AI about your sleep, readiness, and HRV
Ouracli provides a robust command-line interface and an MCP server for the Oura Ring API v2, offering direct access to your personal health data. Key features include:
• Read access to sleep, readiness, HRV, and workout data
• Integrates with agents for data interpretation
• Secure storage of API tokens in your OS keyring
• Public sandbox for credential-free exploration of the API
This tool allows you to easily fetch and analyze your Oura Ring data, enabling a deeper understanding of your health metrics. It presents every Oura API v2 data type, including resilience, cardiovascular age, VO2 max, SpO2, and stress, in a clean JSON format. The self-describing schema allows agents to load a live tool manifest with flags, types, and exit codes, ensuring accurate data retrieval without needing to parse help text.
Built with security in mind, Ouracli ensures that your API tokens remain protected within your OS keychain or an encrypted file, preventing exposure in the agent's context. This design allows for secure interaction with your sensitive health information. Additionally, the option to use Oura's public sandbox provides a safe environment to explore the API's capabilities and data structures before connecting your own ring.
Ouracli is ideal for developers, data analysts, and individuals who want to integrate their Oura Ring data with other applications or agents for personalized health insights. It's perfect for building custom health dashboards, research projects, or personal tracking systems that require direct, secure access to Oura data.