Oura MCP Server

简体中文 | English | 한국어

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.

<a href="https://glama.ai/mcp/servers/@YuzeHao2023/MCP-oura"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@YuzeHao2023/MCP-oura/badge" alt="Oura Server MCP server" /> </a>

All Documents

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

Read our documentation in the following languages:

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

<div align="center"> <h4 align="center"> Maintainers oversee the project's maintenance, decision-making, and long-term development. </h4> <!-- 替换以下占位符为实际维护者信息 --> <a href="https://github.com/YuzeHao2023" target="_blank"> <img src="https://github.com/YuzeHao2023.png" width="100" height="100" style="border-radius: 50%; margin: 0 10px; object-fit: cover;" alt="YuzeHao2023" /> </a> <a href="https://github.com/dvlan26" target="_blank"> <img src="https://github.com/dvlan26.png" width="100" height="100" style="border-radius: 50%; margin: 0 10px; object-fit: cover;" alt="dvlan26" /> </a> <!-- 如需添加更多维护者，复制上方a标签块并修改信息即可 --> </div>

Core Contributors

<div align="center"> <h4 align="center"> The core contributors are the cornerstone of the project. </h4> <a href="https://github.com/YuzeHao2023" target="_blank"> <img src="https://github.com/YuzeHao2023.png" width="100" height="100" style="border-radius: 50%; margin: 0 10px; object-fit: cover;" alt="YuzeHao2023" /> </a> <a href="https://github.com/dvlan26" target="_blank"> <img src="https://github.com/dvlan26.png" width="100" height="100" style="border-radius: 50%; margin: 0 10px; object-fit: cover;" alt="dvlan26" /> </a> <a href="https://github.com/halamji" target="_blank"> <img src="https://github.com/halamji.png" width="100" height="100" style="border-radius: 50%; margin: 0 10px; object-fit: cover;" alt="halamji" /> </a> <a href="https://github.com/yzhao112" target="_blank"> <img src="https://github.com/yzhao112.png" width="100" height="100" style="border-radius: 50%; margin: 0 10px; object-fit: cover;" alt="yzhao112" /> </a> <a href="https://github.com/punkpeye" target="_blank"> <img src="https://github.com/punkpeye.png" width="100" height="100" style="border-radius: 50%; margin: 0 10px; object-fit: cover;" alt="punkpeye" /> </a> <a href="https://github.com/iMilesHo" target="_blank"> <img src="https://github.com/iMilesHo.png" width="100" height="100" style="border-radius: 50%; margin: 0 10px; object-fit: cover;" alt="iMilesHo" /> </a> <a href="https://github.com/Vtwonine" target="_blank"> <img src="https://github.com/Vtwonine.png" width="100" height="100" style="border-radius: 50%; margin: 0 10px; object-fit: cover;" alt="Vtwonine" /> </a> <a href="https://github.com/jillhuang69" target="_blank"> <img src="https://github.com/jillhuang69.png" width="100" height="100" style="border-radius: 50%; margin: 0 10px; object-fit: cover;" alt="jillhuang69" /> </a> </div>