mcpField
O
Oura MCP Server

Oura MCP Server

Local
github.com/tomekkorbakHealth39Updated 87w ago
Repository

About Oura MCP Server

Oura MCP Server is an MCP server that gives language models access to the Oura API for sleep, readiness and resilience data. It is aimed at Oura ring users who want to review their health data from an AI client.

Key features

  1. 01Query sleep, readiness and resilience data by date range
  2. 02Query today's sleep, readiness and resilience data
  3. 03Authenticate with an Oura Personal Access Token
  4. 04Return human-readable error messages

Use cases

  1. 01Ask Claude for Desktop about today's sleep score
  2. 02Review readiness data for the past week
  3. 03Check sleep over a specific date range

MCP support

This project is an MCP server that exposes tools for querying Oura data to MCP clients.

#mcp#oura-ring

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "oura": {
      "command": "uvx",
      "args": [
        "oura-mcp-server"
      ],
      "env": {
        "OURA_API_TOKEN": "<OURA_API_TOKEN>"
      }
    }
  }
}
Run commanduvx oura-mcp-server
Environment variables to set
OURA_API_TOKENSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypioura-mcp-server

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Oura MCP Server

Python Package PyPI version License: MIT 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.

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.