How do I install Oura?

Oura is a local plugin. Install it using npm package: oura-mcp-unofficial and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Yes. Oura passed MCP Marketplace's automated security scan with a score of 10/10 (low risk). Every server on MCP Marketplace is security-scanned before it's listed; see the full security report on this page for the findings and permissions.

What credentials does Oura need?

Oura requires the following credentials or environment variables: OURA_CLIENT_ID, OURA_CLIENT_SECRET, OURA_REDIRECT_URI, OURA_TOKEN_PATH, OURA_PRIVACY_MODE, OURA_CACHE, OURA_CACHE_PATH, OURA_NO_CACHE. You can find setup instructions on the server detail page.

What AI apps work with Oura?

Oura uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Oura MCP Server

by davidmosiah

Developer ToolsLow Risk10.0Local

Free

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

About

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

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

4 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

database

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

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

Environment variable: OURA_CLIENT_ID

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

Environment variable: OURA_CLIENT_SECRET

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

Environment variable: OURA_REDIRECT_URI

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

Environment variable: OURA_TOKEN_PATH

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

Environment variable: OURA_PRIVACY_MODE

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

Environment variable: OURA_CACHE

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

Environment variable: OURA_CACHE_PATH

Set to true to bypass the in-memory HTTP response cache (60s TTL for GET only). POST/PUT/DELETE and 4xx/5xx responses are never cached regardless.Optional

Environment variable: OURA_NO_CACHE

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-davidmosiah-ouramcp": {
      "env": {
        "OURA_CACHE": "your-oura-cache-here",
        "OURA_CLIENT_ID": "your-oura-client-id-here",
        "OURA_CACHE_PATH": "your-oura-cache-path-here",
        "OURA_TOKEN_PATH": "your-oura-token-path-here",
        "OURA_PRIVACY_MODE": "your-oura-privacy-mode-here",
        "OURA_REDIRECT_URI": "your-oura-redirect-uri-here",
        "OURA_CLIENT_SECRET": "your-oura-client-secret-here"
      },
      "args": [
        "-y",
        "oura-mcp-unofficial"
      ],
      "command": "npx"
    }
  }
}