home / mcp / oura mcp server

Oura MCP Server

MCP server for Oura API integration

Installation

Add the following to your MCP client configuration file.

Configuration

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

You can query the Oura API through a dedicated MCP server that exposes sleep, readiness, and resilience data. This enables language models and your applications to fetch structured Oura data on demand using a simple, token-authenticated interface.

How to use

Connect your MCP client to the Oura MCP Server to start querying data. You will run a local MCP process that exposes commands to fetch sleep, readiness, and resilience data for specific date ranges or for today. Once connected, you can ask your MCP-enabled tool or agent to retrieve metrics like today’s sleep score, past readiness data, or a range of resilience measurements. Each query requires your Oura API token for authentication.

How to install

Prerequisites you need: a system capable of running MCP stdio servers (your runtime), and a valid Oura API Personal Access Token.

Install and run the MCP server locally using the documented runtime command. The server is started via a standard stdio configuration that launches the Oura MCP Server process and passes your API token through the environment.

Configuration and security

Security: your API token must be kept secret. Store it in a secure environment variable and do not commit it into code or config files. The MCP server reads the token from the OURA_API_TOKEN variable and uses it to authenticate requests to the Oura API.

Notes and tips

If you encounter errors, verify that your API token is correct and that network access to the Oura API is allowed from your environment. The MCP server will provide human-friendly error messages for common issues such as invalid date formats or authentication failures.

Available tools

get_sleep_data

Fetch sleep data for a specific date range in ISO format (start_date to end_date).

get_readiness_data

Fetch readiness data for a specific date range in ISO format (start_date to end_date).

get_resilience_data

Fetch resilience data for a specific date range in ISO format (start_date to end_date).

get_today_sleep_data

Fetch sleep data for today.

get_today_readiness_data

Fetch readiness data for today.

get_today_resilience_data

Fetch resilience data for today.