Oura MCP Server

by proscar87io.github.proscar87/oura-mcpv0.4.0

Raw access to all Oura Ring API v2 collections with full pagination and page counts, without server-side analysis.

0Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active11d ago

Install Oura MCP server

claude mcp add oura -e OURA_CLIENT_SECRET='<oura-client-secret>' -e OURA_PAT='<oura-pat>' -- uvx mcp-oura

{
  "mcpServers": {
    "oura": {
      "command": "uvx",
      "args": [
        "mcp-oura"
      ],
      "env": {
        "OURA_CLIENT_SECRET": "<oura-client-secret>",
        "OURA_PAT": "<oura-pat>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "oura": {
      "command": "uvx",
      "args": [
        "mcp-oura"
      ],
      "env": {
        "OURA_CLIENT_SECRET": "<oura-client-secret>",
        "OURA_PAT": "<oura-pat>"
      }
    }
  }
}

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

{
  "servers": {
    "oura": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-oura"
      ],
      "env": {
        "OURA_CLIENT_SECRET": "<oura-client-secret>",
        "OURA_PAT": "<oura-pat>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "oura": {
      "command": "uvx",
      "args": [
        "mcp-oura"
      ],
      "env": {
        "OURA_CLIENT_SECRET": "<oura-client-secret>",
        "OURA_PAT": "<oura-pat>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
OURA_SANDBOX	—	—	Set to 1 to use Oura's official synthetic data with no credentials. The recommended way to try the server before authenticating.
OURA_CLIENT_ID	—	—	client_id of your Oura application, for OAuth2. Register one at https://cloud.ouraring.com/oauth/applications with the redirect http://localhost:9876/callback/ (the trailing slash is required).
OURA_CLIENT_SECRET	—	yes	client_secret of your Oura application. Only needed when running `oura-mcp --authorize` and when refreshing the token.
OURA_CREDENTIALS	—	—	Where the OAuth2 credentials file lives. Defaults to ~/.config/oura-mcp/credentials.json, mode 600.
OURA_PAT	—	yes	Oura Personal Access Token. Only if you already had one: Oura stopped issuing them in December 2025.
OURA_PAT_FILE	—	—	Path to a file holding the personal token. Preferable to OURA_PAT: an MCP server is registered in a JSON that gets backed up and shared when asking for help; a separate file rotates without touching the config.

Freshness

Active — last maintenance signal 11d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-29 · 11d ago · GitHub
Latest release
2026-09-27 · 13d ago · GitHub · v0.4.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-27 · 13d ago · official registry · v0.4.0

FAQ

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

Run: claude mcp add oura -e OURA_CLIENT_SECRET='<oura-client-secret>' -e OURA_PAT='<oura-pat>' -- uvx mcp-oura. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Oura require an API key?

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

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

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

›Is Oura in the official MCP registry?

Yes, as io.github.proscar87/oura-mcp.