M

MCP-oura

@YuzeHao2023/MCP-oura
0 Stars 5 次浏览 YuzeHao2023 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

服务介绍

Oura MCP Server

简体中文 | English

Python Package
PyPI version

Python 3.12

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

Core Contributors

相关 MCP 服务