Ouramcp

Give your AI agent your Oura readiness, sleep, activity and HRV without copy-pasting from the Oura app. Its 6 documented tools cover oura, summary. It runs locally over stdio via the published package.

People connecting science & health tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-15 · ★ 2 · #28 OF 60 MAINTAINED SCIENCE & HEALTH · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Ouramcp

before you install - you'll need

Set OURA_CLIENT_ID, OURA_CLIENT_SECRET, OURA_REDIRECT_URI, OURA_SCOPES, OURA_TOKEN_PATH, OURA_CACHE_PATH before connecting. OURA_PRIVACY_MODE, OURA_CACHE are optional or environment-specific per the README.

Claude Code

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

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package oura-mcp-unofficial - unscoped; check the name against the project README before installing

registry namespace io.github.davidmosiah is GitHub-verified and matches the repo owner

03 · What Ouramcp can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 6 documented tools spanning oura, summary, including oura_demo, oura_quickstart, oura_connection_status, oura_data_inventory.

The 6 tools it gives your agent

Extracted from the project's README - what ouramcp lets an agent do.

oura_demo
- realistic synthetic readiness/sleep/activity payloads (no account needed; see Quickstart)
oura_quickstart
- personalized 3-step setup walkthrough that adapts to your current state
oura_connection_status
- verify local setup before calling Oura
oura_data_inventory
- inventory supported data domains, scopes, privacy modes and recommended first calls without calling Oura APIs.
oura_daily_summary
- readiness, sleep, activity and SpO2 brief for today
oura_weekly_summary
- scorecard, comparison vs prior week, next-week plan

Latest releases

v0.4.11 · 2026-07-30

exchange_code intent wording, scorecard 100. npm:

v0.4.10 · 2026-07-30

privacy_mode=raw requires explicit_user_intent

v0.4.9 · 2026-07-30

Release 0.4.9 dual-verify with npm.

04 · Who maintains Ouramcp

ouramcp is maintained by davidmosiah. We track 30 MCP servers from davidmosiah - 30 actively maintained, 113 combined GitHub stars, oldest repo from Apr 2026. Full record: all servers from davidmosiah.

  1. google-health-mcp Privacy-first unofficial Google Health API v4 MCP server for health, sleep, activity, HR agents ★ 45
  2. garminmcp Privacy-first unofficial Garmin Connect MCP for AI health, sleep, activity & recovery agents. ★ 10
  3. whoop-mcp Privacy-first, unofficial WHOOP MCP server for AI health, sleep, recovery, and performance agents. ★ 10
  4. wellness-nourish Local-first nutrition MCP for AI agents: food, barcode, photo, intake, hydration, goals. ★ 8
  5. samsung-health-mcp Unofficial local-first MCP server for Samsung Health personal-data CSV/ZIP exports. ★ 10
  6. withingsmcp Privacy-first, unofficial Withings MCP server for AI health, sleep, activity and heart-rate agents. ★ 4

05 · Facts

category
science & health - ranked #28 of 60 actively-maintained science & health servers as of 2026-08-25.
release cadence
4 releases in the last 90 days (latest 2026-07-30)
registry
io.github.davidmosiah/ouramcp (active, first published 2026-05-05 · 3 versions)
packages
npm:oura-mcp-unofficial

06 · Ouramcp FAQ

Is Ouramcp still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-15 and it shipped 4 releases in the last 90 days. We re-verify nightly.

What can Ouramcp do?

An agent gets 6 documented tools spanning oura, summary, including oura_demo, oura_quickstart, oura_connection_status, oura_data_inventory.

How do I install Ouramcp?

Run `npx -y oura-mcp-unofficial`. The README documents 8 environment variables (OURA_CLIENT_ID, OURA_CLIENT_SECRET, OURA_REDIRECT_URI…) to set first. Set OURA_CLIENT_ID, OURA_CLIENT_SECRET, OURA_REDIRECT_URI, OURA_SCOPES, OURA_TOKEN_PATH, OURA_CACHE_PATH before connecting. OURA_PRIVACY_MODE, OURA_CACHE are optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Ouramcp run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Ouramcp