NestDaddy

Oura Ring Mcp Server

io.github.jordanburke/oura-ring-mcp-server · v0.2.0

Oura Ring MCP server for the Oura API v2: sleep, readiness, activity, heart rate, and more.

Connect Runs on your machine

Terminal
claude mcp add oura-ring-mcp-server -e OURA_CLIENT_ID=<OURA_CLIENT_ID> -e OURA_CLIENT_SECRET=<OURA_CLIENT_SECRET> -e OURA_SANDBOX=<OURA_SANDBOX> -e TRANSPORT_TYPE=<TRANSPORT_TYPE> -e PORT=<PORT> -e HOST=<HOST> -e OURA_TELEMETRY_FILE=<OURA_TELEMETRY_FILE> -e OURA_TELEMETRY_CONSOLE=<OURA_TELEMETRY_CONSOLE> -- npx -y [email protected]
claude_desktop_config.json
{
  "mcpServers": {
    "oura-ring-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "OURA_CLIENT_ID": "<OURA_CLIENT_ID>",
        "OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>",
        "OURA_SANDBOX": "<OURA_SANDBOX>",
        "TRANSPORT_TYPE": "<TRANSPORT_TYPE>",
        "PORT": "<PORT>",
        "HOST": "<HOST>",
        "OURA_TELEMETRY_FILE": "<OURA_TELEMETRY_FILE>",
        "OURA_TELEMETRY_CONSOLE": "<OURA_TELEMETRY_CONSOLE>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "oura-ring-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "OURA_CLIENT_ID": "<OURA_CLIENT_ID>",
        "OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>",
        "OURA_SANDBOX": "<OURA_SANDBOX>",
        "TRANSPORT_TYPE": "<TRANSPORT_TYPE>",
        "PORT": "<PORT>",
        "HOST": "<HOST>",
        "OURA_TELEMETRY_FILE": "<OURA_TELEMETRY_FILE>",
        "OURA_TELEMETRY_CONSOLE": "<OURA_TELEMETRY_CONSOLE>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "oura-ring-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "OURA_CLIENT_ID": "<OURA_CLIENT_ID>",
        "OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>",
        "OURA_SANDBOX": "<OURA_SANDBOX>",
        "TRANSPORT_TYPE": "<TRANSPORT_TYPE>",
        "PORT": "<PORT>",
        "HOST": "<HOST>",
        "OURA_TELEMETRY_FILE": "<OURA_TELEMETRY_FILE>",
        "OURA_TELEMETRY_CONSOLE": "<OURA_TELEMETRY_CONSOLE>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
OURA_CLIENT_ID
Required
Oura OAuth2 client ID (register an app at https://cloud.ouraring.com/oauth/applications, then run `oura-ring-mcp-server login` once to authorize)
OURA_CLIENT_SECRET
Required, secret
Oura OAuth2 client secret from the same application
OURA_SANDBOX
Optional
Use Oura's /sandbox/ demo data instead of real data (true/false, default false)
TRANSPORT_TYPE
Optional
Transport: 'stdio' (default) or 'httpStream' for remote/Docker deployments
PORT
Optional
HTTP port for httpStream transport (default 3000)
HOST
Optional
HTTP host for httpStream transport (default 0.0.0.0)
OURA_TELEMETRY_FILE
Optional
Write NDJSON telemetry events to this file path (safe under any transport)
OURA_TELEMETRY_CONSOLE
Optional
Console telemetry under httpStream transport: true (default) or false

Details

Package[email protected] (NPM, stdio)
First published13 Jul 2026
Last updated13 Jul 2026
Registry nameio.github.jordanburke/oura-ring-mcp-server

More other servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.