Ouramcp MCP Server

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

Local serverstdio

What is the Ouramcp MCP server?

Ouramcp MCP server exists for a simple reason — assistants are far more useful when they can act on Ouramcp directly instead of describing what you should do. Privacy-first, unofficial Oura MCP server for AI health, sleep, activity and heart-rate agents.

What you get

Give your AI agent your Oura readiness, sleep, activity and HRV — without copy-pasting from the Oura app.

What the assistant can call

Once Ouramcp is connected, these are the calls the assistant has available:

  • 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

Configuration and credentials

You will need 4 environment variables: OURA_CLIENT_ID, OURA_CLIENT_SECRET, OURA_TOKEN_PATH, OURA_CACHE_PATH. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Setting it up

delx-wellness-hermes on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Choosing this one

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Ouramcp's toolset — oura_demo, oura_quickstart, oura_connection_status and 3 more — is a fair guide to whether it matches your workflow. It is maintained by davidmosiah; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the ouramcp mcp server does with a few real requests.

Available tools

ToolWhat it does
oura_demorealistic synthetic readiness/sleep/activity payloads (no account needed; see [Quickstart](#quickstart-see-the-data-before-you-connect))
oura_quickstartpersonalized 3-step setup walkthrough that adapts to your current state
oura_connection_statusverify local setup before calling Oura
oura_data_inventoryinventory supported data domains, scopes, privacy modes and recommended first calls without calling Oura APIs.
oura_daily_summaryreadiness, sleep, activity and SpO2 brief for today
oura_weekly_summaryscorecard, comparison vs prior week, next-week plan

How to install the Ouramcp MCP server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
OURA_CLIENT_IDConfiguration value read at startup.Optional
OURA_CLIENT_SECRETCredential the server authenticates with.Yes
OURA_TOKEN_PATHCredential the server authenticates with.Yes
OURA_CACHE_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • Use Ouramcp to oura demo.
  • Use Ouramcp to oura quickstart.
  • Use Ouramcp to oura connection status.

Frequently asked questions

It connects Ouramcp to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (oura_demo, oura_quickstart, oura_connection_status, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Ouramcp directly.