Oura MCP Server

What is oura-mcp-server

oura-mcp-server is a specialized server developed by tomekkorbak, designed to bridge the gap between AI systems and the Oura API. The server utilizes the Model Context Protocol (MCP) to allow language models to securely access and query sleep, readiness, and resilience data. This protocol enables AI systems to connect seamlessly with various data sources, providing a universal standard for accessing real-time information.

How to Use oura-mcp-server

Using oura-mcp-server involves a few straightforward steps. First, you need an Oura API token, which you can obtain by creating a Personal Access Token through the Oura Developer Portal. Once you have your token, you can configure your system to connect to the server.

If you're using Claude for Desktop, update your claude_desktop_config.json file. This involves specifying the server command and passing your Oura API token as an environment variable. Here's a simple configuration example:

{
    "mcpServers": {
        "oura": {
            "command": "uvx",
            "args": [
                "oura-mcp-server"
            ],
            "env": {
                "OURA_API_TOKEN": "YOUR_OURA_API_TOKEN"
            }
        }
    }
}

Once configured, you can start querying the server to get insights into your sleep, readiness, and resilience data. For example, you can ask questions like, "What's my sleep score for today?" or "Show me my readiness data for the past week."

Key Features of oura-mcp-server

oura-mcp-server offers several key features that make it a powerful tool for accessing personal wellness data:

• Date Range Queries: Retrieve sleep, readiness, and resilience data for specific date ranges using functions like get_sleep_data(start_date, end_date). Dates must be in ISO format (YYYY-MM-DD).

• Today's Data Queries: Instantly access today's wellness data with simple commands such as get_today_sleep_data().

• Example Queries: Once connected, users can execute simple natural language queries through AI assistants, such as checking today's sleep score or reviewing weekly readiness data.

• Error Handling: The server provides user-friendly error messages to handle common issues like invalid date formats, authentication errors, and network problems, ensuring a smooth user experience.

• Open-Source and Flexible: Built under the MIT License, oura-mcp-server is open-source, allowing for flexibility and adaptation to various use cases.

With its robust features and user-friendly design, oura-mcp-server is an essential tool for anyone looking to seamlessly integrate Oura data with AI systems, enhancing personal health insights and decision-making.