io.github.davidmosiah/ouramcp

io.github.davidmosiah/ouramcp·v0.1.1·Other

Quality Score

/100

Privacy-first, unofficial Oura MCP server for AI health, sleep, activity and heart-rate agents.

Repository →

§01 Install

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "ouramcp": {
      "command": "npx",
      "args": [
        "-y",
        "oura-mcp-unofficial"
      ],
      "env": {
        "OURA_CLIENT_ID": "<oura_client_id>",
        "OURA_CLIENT_SECRET": "<your-oura_client_secret>",
        "OURA_REDIRECT_URI": "<oura_redirect_uri>",
        "OURA_TOKEN_PATH": "<oura_token_path>",
        "OURA_PRIVACY_MODE": "<oura_privacy_mode>",
        "OURA_CACHE": "<oura_cache>",
        "OURA_CACHE_PATH": "<oura_cache_path>"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "ouramcp": {
      "command": "npx",
      "args": [
        "-y",
        "oura-mcp-unofficial"
      ],
      "env": {
        "OURA_CLIENT_ID": "<oura_client_id>",
        "OURA_CLIENT_SECRET": "<your-oura_client_secret>",
        "OURA_REDIRECT_URI": "<oura_redirect_uri>",
        "OURA_TOKEN_PATH": "<oura_token_path>",
        "OURA_PRIVACY_MODE": "<oura_privacy_mode>",
        "OURA_CACHE": "<oura_cache>",
        "OURA_CACHE_PATH": "<oura_cache_path>"
      }
    }
  }
}

Cline (cline_mcp_settings.json)

npx -y oura-mcp-unofficial

§02 Environment variables

OURA_CLIENT_ID

Oura OAuth client ID. Optional when configured with oura-mcp-server setup.

OURA_CLIENT_SECRET

secret

Oura OAuth client secret. Prefer oura-mcp-server setup so this secret is stored in ~/.oura-mcp/config.json instead of MCP client config.

OURA_REDIRECT_URI

Redirect URI configured in the Oura Developer Dashboard. Optional when configured with oura-mcp-server setup.

OURA_TOKEN_PATH

Optional local path for OAuth tokens. Defaults to ~/.oura-mcp/tokens.json.

OURA_PRIVACY_MODE

Optional payload mode: summary, structured, or raw. Defaults to structured. raw means full Oura API payloads, not continuous 24/7 raw sensor telemetry.

OURA_CACHE

Optional SQLite cache toggle. Set to true or sqlite to enable.

OURA_CACHE_PATH

Optional local SQLite cache path. Defaults to ~/.oura-mcp/cache.sqlite.

§03 MCP Quality Score · methodology

freshness

completeness

installability

documentation

stability

§04 Alternatives in Other

agency.lona/trading