Skip to content
MCP server

Oura MCP

The Oura v2 API as an MCP server. Paginates, fixes the date range, warns when data is…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.4.0
Listing updated
5 days ago

About Oura MCP

Oura MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

The Oura v2 API as an MCP server. Paginates, fixes the date range, warns when data is missing.

Install

Run in a terminal

claude mcp add oura-mcp --env OURA_CLIENT_SECRET='<OURA_CLIENT_SECRET>' --env OURA_PAT='<OURA_PAT>' -- uvx mcp-oura

Add to claude_desktop_config.json

{
  "mcpServers": {
    "oura-mcp": {
      "command": "uvx",
      "args": [
        "mcp-oura"
      ],
      "env": {
        "OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>",
        "OURA_PAT": "<OURA_PAT>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "oura-mcp": {
      "command": "uvx",
      "args": [
        "mcp-oura"
      ],
      "env": {
        "OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>",
        "OURA_PAT": "<OURA_PAT>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "oura-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-oura"
      ],
      "env": {
        "OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>",
        "OURA_PAT": "<OURA_PAT>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "oura-mcp": {
      "command": "uvx",
      "args": [
        "mcp-oura"
      ],
      "env": {
        "OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>",
        "OURA_PAT": "<OURA_PAT>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "oura-mcp": {
      "command": "uvx",
      "args": [
        "mcp-oura"
      ],
      "env": {
        "OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>",
        "OURA_PAT": "<OURA_PAT>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • OURA_SANDBOXSet to 1 to use Oura's official synthetic data with no credentials. The recommended way to try the server before authenticating.
  • OURA_CLIENT_IDclient_id of your Oura application, for OAuth2. Register one at https://cloud.ouraring.com/oauth/applications with the redirect http://localhost:9876/callback/ (the trailing slash is required).
  • OURA_CLIENT_SECRETclient_secret of your Oura application. Only needed when running `oura-mcp --authorize` and when refreshing the token.
  • OURA_CREDENTIALSWhere the OAuth2 credentials file lives. Defaults to ~/.config/oura-mcp/credentials.json, mode 600.
  • OURA_PATOura Personal Access Token. Only if you already had one: Oura stopped issuing them in December 2025.
  • OURA_PAT_FILEPath to a file holding the personal token. Preferable to OURA_PAT: an MCP server is registered in a JSON that gets backed up and shared when asking for help; a separate file rotates without touching the config.

Pricing

Open source

Oura MCP FAQ

Is Oura MCP free?

Yes. Oura MCP is open source, so you can use and self-host it for free.

How do I add Oura MCP to Claude Code?

Run this command in your terminal: claude mcp add oura-mcp --env OURA_CLIENT_SECRET='<OURA_CLIENT_SECRET>' --env OURA_PAT='<OURA_PAT>' -- uvx mcp-oura

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers