Oura MCP Server

@elizabethtrykin

About Oura MCP Server

An MCP server for oura

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "oura": {
      "command": "node",
      "args": [
        "/absolute/path/to/oura-mcp/build/index.js"
      ],
      "env": {
        "OURA_PERSONAL_ACCESS_TOKEN": "your_token"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Oura MCP Server?

Oura MCP Server is a Model Context Protocol (MCP) server that provides access to Oura Ring data. It enables developers to retrieve health metrics—such as sleep, activity, readiness, and stress—via MCP clients like Claude Desktop.

How to use Oura MCP Server?

Install Node.js v16+, clone the repository, run npm install and npm run build. Configure credentials in a .env file using a Personal Access Token (for testing) or OAuth2 credentials (for production). Test with node test.js <tool_name> <date> (e.g., node test.js get_daily_sleep 2023-05-01). For Claude Desktop, add the server to its MCP config with the oura key, specifying the build path and environment variable for the access token.

Key features of Oura MCP Server

Accesses 15+ Oura Ring data resources (e.g., daily_sleep, daily_activity)
Supports Personal Access Token and OAuth2 authentication
Integrates directly with Claude Desktop via MCP
Provides date‑filtered tools (e.g., get_daily_sleep)
Returns structured JSON for each resource

Use cases of Oura MCP Server

Retrieve daily sleep summaries and detailed sleep data
Fetch daily activity, readiness, and resilience scores
Access workout and session data for fitness analysis
Integrate Oura health metrics into AI‑powered applications

FAQ from Oura MCP Server

What prerequisites are needed?

Node.js v16+ and a valid Oura account. Credentials come from the Oura Cloud Console.

How do I authenticate with Oura MCP Server?

You can use a Personal Access Token (quick start) or OAuth2 client ID/secret (production). Set the appropriate environment variables in a .env file.

How do I integrate Oura MCP Server with Claude Desktop?

Add an oura entry to Claude Desktop’s MCP config file. Specify the command (node), the absolute path to build/index.js, and the access token as an environment variable.

What data does Oura MCP Server expose?

It exposes 15 resources including personal info, daily activity, sleep, readiness, workouts, sessions, SpO2, stress, resilience, cardiovascular age, and VO2 max.

How can I test a tool?

Run node test.js <tool_name> <date> from the project root, replacing <tool_name> with a tool like get_daily_sleep and <date> with a YYYY-MM-DD date.

Frequently asked questions