Oura MCP Server

🚀 Oura MCP Server

An Model Context Protocol (MCP) server that provides access to the Oura API. It allows language models to query sleep, readiness, and resilience data.

🚀 Quick Start

To use this server, you need an Oura API token. You can obtain it by following these steps:

1. Go to the Oura Developer Console.
2. Create a personal access token.

Claude for Desktop

Update your claude_desktop_config.json (located at ~/Library/Application\ Support/Claude/claude_desktop_config.json on macOS and %APPDATA%/Claude/claude_desktop_config.json on Windows) to include the following content:

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

✨ Features

Available Tools

The server exposes the following tools:

Date Range Queries

• get_sleep_data(start_date: str, end_date: str): Get sleep data for a specified date range.
• get_readiness_data(start_date: str, end_date: str): Get readiness data for a specified date range.
• get_resilience_data(start_date: str, end_date: str): Get resilience data for a specified date range.

Dates should be provided in ISO format (YYYY-MM-DD).

Today's Data Queries

• get_today_sleep_data(): Get today's sleep data.
• get_today_readiness_data(): Get today's readiness data.
• get_today_resilience_data(): Get today's resilience data.

💻 Usage Examples

Example Queries

Once connected, you can ask Claude questions like:

• "What's my sleep score today?"
• "Show me my readiness data for the past week."
• "How was my sleep from January 1st to January 7th?"
• "What's today's resilience score?"

🔧 Technical Details

Error Handling

The server provides easy-to-understand error messages for common issues:

• Invalid date format
• API authentication errors
• Network connection issues

📄 License

This project is released under the MIT License. See the LICENSE file for details.