ouramcp

Name: ouramcp
Author: davidmosiah

Community

MCP server by davidmosiah · updated 14 days ago · ★ 4 · 108 downloads a week

Score 74

Privacy-first, unofficial Oura MCP server for AI health, sleep, activity and heart-rate agents. ouramcp is a community project by davidmosiah, not verified by a company domain.

Install Add to Cursor Add to VS Code GitHub Website

Yours? Claim it

Works withClaude Code Claude Desktop Cursor Codex Gemini CLI VS Code Windsurf Antigravity CLI

Maintenance

Last commit 14 days ago

Licence

MIT: permissive, fine for commercial use

Quality

Clear description, published package or server URL, original repository

Security

No risky patterns in the files we checked

What you need

Setting	Needed	What it is
`OURA_CLIENT_ID`Environment variable	Optional	Oura OAuth client ID. Optional when configured with oura-mcp-server setup.
`OURA_CLIENT_SECRET`Environment variable, secret	Optional	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`Environment variable	Optional	Redirect URI configured in the Oura Developer Dashboard. Optional when configured with oura-mcp-server setup.
`OURA_TOKEN_PATH`Environment variable	Optional	Optional local path for OAuth tokens. Defaults to ~/.oura-mcp/tokens.json.
`OURA_PRIVACY_MODE`Environment variable	Optional	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`Environment variable	Optional	Optional SQLite cache toggle. Set to true or sqlite to enable.
`OURA_CACHE_PATH`Environment variable	Optional	Optional local SQLite cache path. Defaults to ~/.oura-mcp/cache.sqlite.
`OURA_NO_CACHE`Environment variable	Optional	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.

From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.

Install ouramcp

Built from the published package, never by AI

claude mcp add ouramcp -- npx -y oura-mcp-unofficial

Run in your terminal. Add --scope user to use it in every project.

Step-by-step: install ouramcp in Claude Code

{
  "mcpServers": {
    "ouramcp": {
      "command": "npx",
      "args": [
        "-y",
        "oura-mcp-unofficial"
      ]
    }
  }
}

Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.

Step-by-step: install ouramcp in Claude Desktop

{
  "mcpServers": {
    "ouramcp": {
      "command": "npx",
      "args": [
        "-y",
        "oura-mcp-unofficial"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).

Step-by-step: install ouramcp in Cursor

{
  "servers": {
    "ouramcp": {
      "command": "npx",
      "args": [
        "-y",
        "oura-mcp-unofficial"
      ]
    }
  }
}

Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".

Step-by-step: install ouramcp in VS Code

codex mcp add ouramcp -- npx -y oura-mcp-unofficial

Step-by-step: install ouramcp in Codex

{
  "mcpServers": {
    "ouramcp": {
      "command": "npx",
      "args": [
        "-y",
        "oura-mcp-unofficial"
      ]
    }
  }
}

Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).

Step-by-step: install ouramcp in Antigravity CLI

gemini mcp add ouramcp npx -y oura-mcp-unofficial

Gemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.

Step-by-step: install ouramcp in Gemini CLI

MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the ouramcp block.

Weekly newsletter

Like ouramcp? Get the best new MCP servers every week

The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.

Security check

No download-and-run commands, hidden instructions or signs of sending keys out were found.

Checked automatically: README.md, package.json. This looks for known risky patterns and is not a full audit. How grades work

Alternatives to ouramcp

All alternatives →

Jay Code ruvnet

Streamlined AI CLI orchestration engine with mathematical rigor and enterprise-grade reliability

AAA Local 78k

Apple Healthneiltron

Local-first Apple Health MCP server for questions about your sleep, workouts and heart data.

AAA Local 574

codescene-mcp-server codescene-oss

An MCP server that provides CodeScene Code Health analysis tools.

AFB Local 2.0k/wk

IBGE Brasil MCPSidneyBissoli

IBGE: geography, census, economy and health from the official APIs, with provenance. 23 tools.

AAC Local and remote 2.3k/wk

Jacobianmorluto

Executable mathematics and independent verification for AI agents.

AAB Local 306

Dsh MCP Panel PerryLink

MCP management console for the official DeepSeek Harness MCP client: /mcp command with health diagnostics and pipeline trial calls, a Settings MCP tab with server CRUD (append-only profile-patch fragments, approval-gated writes with automatic backups), a

AAB Local 1.9k/wk

ouramcp vs Jay Code ouramcp vs Apple Health ouramcp vs codescene-mcp-server

ouramcp: common questions

How do I install ouramcp?

In Claude Code run claude mcp add ouramcp -- npx -y oura-mcp-unofficial. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.

Is ouramcp the official server?

ouramcp is a community project by davidmosiah, not verified by a company domain.

Is ouramcp free?

The code is published under the MIT licence. The service it connects to may have its own pricing.

Is ouramcp safe to use?

It scores 74 of 100. Grades: maintenance A, licence A, quality C. Security check: grade A, no risky patterns found in the files checked. Review the code before you install. How grades work.

What are alternatives to ouramcp?

Similar MCP servers: Jay Code, Apple Health, codescene-mcp-server, IBGE Brasil MCP.

Does ouramcp work with ChatGPT?

Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.