Oura Ring MCP Server

by mitchhankins01io.github.mitchhankins01/oura-ring-mcpv0.1.4

Connect your Oura Ring to Claude AI assistants. Health metrics with smart analysis tools.

29Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Stale8mo ago

Install Oura Ring MCP server

claude mcp add oura-ring-mitchhankins01 -e OURA_ACCESS_TOKEN='<oura-access-token>' -e OURA_CLIENT_SECRET='<oura-client-secret>' -- npx -y oura-ring-mcp

{
  "mcpServers": {
    "oura-ring-mitchhankins01": {
      "command": "npx",
      "args": [
        "-y",
        "oura-ring-mcp"
      ],
      "env": {
        "OURA_ACCESS_TOKEN": "<oura-access-token>",
        "OURA_CLIENT_SECRET": "<oura-client-secret>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "oura-ring-mitchhankins01": {
      "command": "npx",
      "args": [
        "-y",
        "oura-ring-mcp"
      ],
      "env": {
        "OURA_ACCESS_TOKEN": "<oura-access-token>",
        "OURA_CLIENT_SECRET": "<oura-client-secret>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "oura-ring-mitchhankins01": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "oura-ring-mcp"
      ],
      "env": {
        "OURA_ACCESS_TOKEN": "<oura-access-token>",
        "OURA_CLIENT_SECRET": "<oura-client-secret>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "oura-ring-mitchhankins01": {
      "command": "npx",
      "args": [
        "-y",
        "oura-ring-mcp"
      ],
      "env": {
        "OURA_ACCESS_TOKEN": "<oura-access-token>",
        "OURA_CLIENT_SECRET": "<oura-client-secret>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
OURA_ACCESS_TOKEN	—	yes	Oura Personal Access Token (get from cloud.ouraring.com/personal-access-tokens)
OURA_CLIENT_ID	—	—	OAuth Client ID (alternative to access token, from developer.ouraring.com)
OURA_CLIENT_SECRET	—	yes	OAuth Client Secret (required with OURA_CLIENT_ID)

Freshness

Stale — last maintenance signal 8mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-02-08 · 8mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-01-25 · 9mo ago · official registry · v0.1.4

FAQ

›How do I install the Oura Ring MCP server in Claude Code?

Run: claude mcp add oura-ring-mitchhankins01 -e OURA_ACCESS_TOKEN='<oura-access-token>' -e OURA_CLIENT_SECRET='<oura-client-secret>' -- npx -y oura-ring-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Oura Ring require an API key?

Yes. It expects OURA_ACCESS_TOKEN, OURA_CLIENT_SECRET, of which 2 are secrets.

›Can I use Oura Ring as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Oura Ring in the official MCP registry?

Yes, as io.github.mitchhankins01/oura-ring-mcp.