# ouramcp

ouramcp is an MCP server for Claude Code that connects an agent to Oura readiness, sleep, activity, and HRV data. It uses OAuth to access an Oura account.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: davidmosiah
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davidmosiah/oura-mcp
- Updated: 2026-11-05
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/ouramcp

## What it does

ouramcp gives an agent access to Oura Ring metrics, including readiness, sleep, daily activity, and HRV. It handles OAuth on the local machine and reshapes responses from separate API endpoints. Tokens stay on that machine; raw responses are opt-in through privacy settings.

Setup requires an Oura app with a `client id`, a `client secret`, and the redirect URI `http://127.0.0.1:3000/callback`. Authorization runs through a browser. The server starts with `npx`; `stdio` is the default transport, while its optional HTTP mode listens on loopback only.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `OURA_CLIENT_ID`, `OURA_CLIENT_SECRET`, `OURA_REDIRECT_URI`, `OURA_TOKEN_PATH`, `OURA_PRIVACY_MODE`, `OURA_CACHE`, `OURA_CACHE_PATH`, `OURA_NO_CACHE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env OURA_CLIENT_ID=<OURA_CLIENT_ID> --env OURA_CLIENT_SECRET=<OURA_CLIENT_SECRET> --env OURA_REDIRECT_URI=<OURA_REDIRECT_URI> --env OURA_TOKEN_PATH=<OURA_TOKEN_PATH> --env OURA_PRIVACY_MODE=<OURA_PRIVACY_MODE> --transport stdio ouramcp -- npx -y oura-mcp-unofficial
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add ouramcp --env OURA_CLIENT_ID=<OURA_CLIENT_ID> --env OURA_CLIENT_SECRET=<OURA_CLIENT_SECRET> --env OURA_REDIRECT_URI=<OURA_REDIRECT_URI> --env OURA_TOKEN_PATH=<OURA_TOKEN_PATH> --env OURA_PRIVACY_MODE=<OURA_PRIVACY_MODE> -- npx -y oura-mcp-unofficial
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ouramcp": {
            "command": "npx",
            "args": [
                "-y",
                "oura-mcp-unofficial"
            ],
            "env": {
                "OURA_CLIENT_ID": "<OURA_CLIENT_ID>",
                "OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>",
                "OURA_REDIRECT_URI": "<OURA_REDIRECT_URI>",
                "OURA_TOKEN_PATH": "<OURA_TOKEN_PATH>",
                "OURA_PRIVACY_MODE": "<OURA_PRIVACY_MODE>"
            }
        }
    }
}
```
Replace <…> with your own values. 3 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ouramcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "oura-mcp-unofficial"
            ],
            "env": {
                "OURA_CLIENT_ID": "<OURA_CLIENT_ID>",
                "OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>",
                "OURA_REDIRECT_URI": "<OURA_REDIRECT_URI>",
                "OURA_TOKEN_PATH": "<OURA_TOKEN_PATH>",
                "OURA_PRIVACY_MODE": "<OURA_PRIVACY_MODE>"
            }
        }
    }
}
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e OURA_CLIENT_ID=<OURA_CLIENT_ID> -e OURA_CLIENT_SECRET=<OURA_CLIENT_SECRET> -e OURA_REDIRECT_URI=<OURA_REDIRECT_URI> -e OURA_TOKEN_PATH=<OURA_TOKEN_PATH> -e OURA_PRIVACY_MODE=<OURA_PRIVACY_MODE> ouramcp npx -y oura-mcp-unofficial
```
Replace <…> with your own values. 3 more environment variables are in the server README

## When to use it
- send Oura readiness scores to an agent
- review sleep and activity metrics together
- access HRV data through MCP

## Example prompts
- Show my latest Oura readiness and sleep metrics.
- Compare my recent activity and HRV data.
- Summarize what my Oura sleep data shows.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
