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 who work with oura and summary and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-10 · ★ 4 · #25 OF 71 MAINTAINED SCIENCE & HEALTH · VERIFIED 2026-09-18

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.7.3 · 2026-09-10

Doctor accepts Oura extapi: granted scopes after full consent (#11). Collection list tools default a 30-day lookback when after/before are omitted (#13).

v0.7.2 · 2026-08-29

Skill layer next to MCP. Same binary: MCP tools or call <tool> --json. Mutation gates identical.

v0.7.1 · 2026-08-26

OAuth PKCE S256 and 128-bit state.

04 · Who maintains Ouramcp

ouramcp is maintained by davidmosiah. We track 30 MCP servers from davidmosiah - 30 actively maintained, 144 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 ★ 57
  2. garminmcp Privacy-first unofficial Garmin Connect MCP for AI health, sleep, activity & recovery agents. ★ 12
  3. whoop-mcp Privacy-first, unofficial WHOOP MCP server for AI health, sleep, recovery, and performance agents. ★ 13
  4. wellness-nourish Local-first nutrition MCP for AI agents: food, barcode, photo, intake, hydration, goals. ★ 9
  5. samsung-health-mcp Unofficial local-first MCP server for Samsung Health personal-data CSV/ZIP exports. ★ 14
  6. eight-sleep-mcp Unofficial Eight Sleep MCP server: read sleep trends, temperature, alarms; gated pod control. ★ 4

05 · Facts

category
science & health - ranked #25 of 71 actively-maintained science & health servers as of 2026-09-18.
release cadence
7 releases in the last 90 days (latest 2026-09-10)
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-09-18, its last commit was 2026-09-10 and it shipped 7 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