Oura Ring MCP Server

Name: Oura Ring MCP Server
Author: io.github.AntVsl

io.github.AntVsl/oura-mcp

Repository Registry

What is the Oura Ring MCP server?

Sleep, readiness, HRV, resting heart rate, activity and stress from your Oura Ring

How to install Oura Ring

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

OURA_CLIENT_ID
Client ID of your Oura application from developer.ouraring.com
OURA_CLIENT_SECRET
secret
Client secret of your Oura application
OURA_REDIRECT_URI
OAuth redirect URI; must match the Oura application byte for byte
OURA_API_MODE
sandbox for Oura's synthetic data (no auth needed), production for your own
OURA_TZ
IANA timezone deciding what counts as today. Set it explicitly on servers, whose clocks run in UTC
OURA_TOKEN_STORE
Where the OAuth flow stores tokens. Written by the server, not set by hand
OURA_PUBLIC_URL
Public https address, without a trailing slash. Enables OAuth 2.1 for Claude.ai and ChatGPT; leave empty for local or Bearer-token clients
OURA_OAUTH_ALLOWED_REDIRECT_ORIGINS
Comma-separated trusted OAuth redirect origins; defaults to Claude.ai and ChatGPT
OURA_MCP_TOKEN
required
secret
Shared secret guarding the HTTP endpoint. Required whenever the server binds to anything other than loopback; without it the server refuses to start

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "oura-mcp": {
      "command": "uvx",
      "args": [
        "my-oura-mcp"
      ],
      "env": {
        "OURA_CLIENT_ID": "<YOUR_OURA_CLIENT_ID>",
        "OURA_CLIENT_SECRET": "<YOUR_OURA_CLIENT_SECRET>",
        "OURA_REDIRECT_URI": "<YOUR_OURA_REDIRECT_URI>",
        "OURA_API_MODE": "<YOUR_OURA_API_MODE>",
        "OURA_TZ": "<YOUR_OURA_TZ>",
        "OURA_TOKEN_STORE": "<YOUR_OURA_TOKEN_STORE>",
        "OURA_PUBLIC_URL": "<YOUR_OURA_PUBLIC_URL>",
        "OURA_OAUTH_ALLOWED_REDIRECT_ORIGINS": "<YOUR_OURA_OAUTH_ALLOWED_REDIRECT_ORIGINS>",
        "OURA_MCP_TOKEN": "<YOUR_OURA_MCP_TOKEN>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "oura-mcp": {
      "command": "uvx",
      "args": [
        "my-oura-mcp"
      ],
      "env": {
        "OURA_CLIENT_ID": "<YOUR_OURA_CLIENT_ID>",
        "OURA_CLIENT_SECRET": "<YOUR_OURA_CLIENT_SECRET>",
        "OURA_REDIRECT_URI": "<YOUR_OURA_REDIRECT_URI>",
        "OURA_API_MODE": "<YOUR_OURA_API_MODE>",
        "OURA_TZ": "<YOUR_OURA_TZ>",
        "OURA_TOKEN_STORE": "<YOUR_OURA_TOKEN_STORE>",
        "OURA_PUBLIC_URL": "<YOUR_OURA_PUBLIC_URL>",
        "OURA_OAUTH_ALLOWED_REDIRECT_ORIGINS": "<YOUR_OURA_OAUTH_ALLOWED_REDIRECT_ORIGINS>",
        "OURA_MCP_TOKEN": "<YOUR_OURA_MCP_TOKEN>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "oura-mcp": {
      "command": "uvx",
      "args": [
        "my-oura-mcp"
      ],
      "env": {
        "OURA_CLIENT_ID": "<YOUR_OURA_CLIENT_ID>",
        "OURA_CLIENT_SECRET": "<YOUR_OURA_CLIENT_SECRET>",
        "OURA_REDIRECT_URI": "<YOUR_OURA_REDIRECT_URI>",
        "OURA_API_MODE": "<YOUR_OURA_API_MODE>",
        "OURA_TZ": "<YOUR_OURA_TZ>",
        "OURA_TOKEN_STORE": "<YOUR_OURA_TOKEN_STORE>",
        "OURA_PUBLIC_URL": "<YOUR_OURA_PUBLIC_URL>",
        "OURA_OAUTH_ALLOWED_REDIRECT_ORIGINS": "<YOUR_OURA_OAUTH_ALLOWED_REDIRECT_ORIGINS>",
        "OURA_MCP_TOKEN": "<YOUR_OURA_MCP_TOKEN>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "oura-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "my-oura-mcp"
      ],
      "env": {
        "OURA_CLIENT_ID": "<YOUR_OURA_CLIENT_ID>",
        "OURA_CLIENT_SECRET": "<YOUR_OURA_CLIENT_SECRET>",
        "OURA_REDIRECT_URI": "<YOUR_OURA_REDIRECT_URI>",
        "OURA_API_MODE": "<YOUR_OURA_API_MODE>",
        "OURA_TZ": "<YOUR_OURA_TZ>",
        "OURA_TOKEN_STORE": "<YOUR_OURA_TOKEN_STORE>",
        "OURA_PUBLIC_URL": "<YOUR_OURA_PUBLIC_URL>",
        "OURA_OAUTH_ALLOWED_REDIRECT_ORIGINS": "<YOUR_OURA_OAUTH_ALLOWED_REDIRECT_ORIGINS>",
        "OURA_MCP_TOKEN": "<YOUR_OURA_MCP_TOKEN>"
      }
    }
  }
}

Claude Code

claude mcp add oura-mcp --env OURA_CLIENT_ID=<YOUR_OURA_CLIENT_ID> --env OURA_CLIENT_SECRET=<YOUR_OURA_CLIENT_SECRET> --env OURA_REDIRECT_URI=<YOUR_OURA_REDIRECT_URI> --env OURA_API_MODE=<YOUR_OURA_API_MODE> --env OURA_TZ=<YOUR_OURA_TZ> --env OURA_TOKEN_STORE=<YOUR_OURA_TOKEN_STORE> --env OURA_PUBLIC_URL=<YOUR_OURA_PUBLIC_URL> --env OURA_OAUTH_ALLOWED_REDIRECT_ORIGINS=<YOUR_OURA_OAUTH_ALLOWED_REDIRECT_ORIGINS> --env OURA_MCP_TOKEN=<YOUR_OURA_MCP_TOKEN> -- uvx my-oura-mcp