Oura

Provides access to the Oura API through MCP, enabling range and today queries for sleep, readiness, and resilience data.

python

34

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

This MCP (Model Context Protocol) server provides programmatic access to the Oura API, letting you query sleep, readiness, and resilience data. It enables large language models and automated tools to retrieve personal wellness information quickly and securely by issuing standardized data requests.

How to use

Connect to the Oura MCP Server using a local runtime that supports MCP stdio configurations. You’ll run the MCP server as a local process and supply your Oura API token so the server can fetch data from the Oura service. Once running, you can ask your MCP client questions about your sleep, readiness, and resilience data for today or for a specific date range.

How to install

Prerequisites: you need a runtime capable of launching MCP stdio servers. In this example, you’ll use the uvx runtime to run a local MCP server.

Ensure you have Python installed if you later rely on Python tools, or simply use the runtime that executes the MCP server directly.
Install the uvx runtime globally on your system so you can start local MCP servers.
Start the Oura MCP Server with your Oura API token. Use the provided runtime command and supply the token via the environment. The server will be started as a local process and will listen for MCP requests from your client.

Configuration and usage notes

Environment variables you should set for the server include your Oura API token. This token authenticates requests to the Oura API and must be kept secure.

Example run command (to be provided by your MCP client setup): set the OURA_API_TOKEN in your environment and run the MCP server via the stdio configuration below.

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

Available tools

get_sleep_data

Fetch sleep data for a specified date range using ISO format dates.

get_readiness_data

Fetch readiness data for a specified date range using ISO format dates.

get_resilience_data

Fetch resilience data for a specified date range using ISO format dates.

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.