MCP Oura

Oura MCP Server

[简体中文](./READMEzhCN.md) | English | 한국어

[](https://badge.fury.io/py/oura-mcp-server) [](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/release/python-3120/)

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

All Documents

> Call for translators! We're looking for translators to help translate this spec for everyone!

Read our documentation in the following languages:

| Language | Link | | -------- | --------------------------------------------------------------- | | English | English | | 中文 | 中文 | | 한국어 | 한국어 |

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 specific date range
• get_readiness_data(start_date: str, end_date: str): Get readiness data for a specific date range
• get_resilience_data(start_date: str, end_date: str): Get resilience data for a specific date range

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

Today's Data Queries

• get_today_sleep_data(): Get sleep data for today
• get_today_readiness_data(): Get readiness data for today
• get_today_resilience_data(): Get resilience data for today

Usage

You'll need an Oura API token to use this server. You can obtain one by:

1. Going to the Oura Developer Portal
2. Creating a Personal Access Token

Claude for Desktop

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

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

Example Queries

Once connected, you can ask Claude questions like:

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

Error Handling

The server provides human-readable error messages for common issues:

• Invalid date formats
• API authentication errors
• Network connectivity problems

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Maintainer

Maintainers oversee the project's maintenance, decision-making, and long-term development.

Core Contributors

The core contributors are the cornerstone of the project.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: YuzeHao2023
• Source: YuzeHao2023/MCP-oura
• License: MIT

Install and usage instructions live in the source repository linked above.