# Oura Ring MCP

> A community MCP server, not by Oura: your agent reads your Oura Ring sleep, readiness and activity data and looks for patterns.

A community-built MCP server by Mitch Hankins (mitchhankins01) for the Oura Ring. It isn't made by Oura. It lets your agent read your sleep, readiness, activity and other Oura data through Oura's own API, formatted so it's easy to read, and work out trends, comparisons and unusual readings from it.

What you can do with it
- Check last night's sleep: stages, efficiency, heart rate, HRV and what went into your score
- See today's readiness score and its contributors
- Look at activity, workouts, meditation sessions, heart rate, stress, SpO2 and more
- Find unusual readings, compare this week with last, and follow your HRV trend
- Compare days with and without one of your Oura tags, and see what goes with your best nights of sleep
- Start from its built-in prompts for a weekly review, a recovery check or a sleep review

How it connects
It runs on your machine with npx oura-ring-mcp and needs Node.js 18 or newer. It needs your Oura sign-in in one of two ways:
- OAuth: create an OAuth application in Oura's developer portal, set OURA_CLIENT_ID and OURA_CLIENT_SECRET, and run npx oura-ring-mcp auth once. It saves your credentials in ~/.oura-mcp/credentials.json. Give the server the same client ID and secret if you want it to refresh the token itself.
- A personal access token in OURA_ACCESS_TOKEN. Oura now marks personal access tokens as deprecated, so OAuth is the route to rely on.
The server won't start if it finds neither, and the install steps here don't add the token for you.

Good to know
- It only reads your Oura data. It has no tools that change anything in your account.
- The maker also documents running it as a remote server you deploy and host yourself.
- It works with your own wearable data. What your agent says about it isn't medical advice; talk to a doctor about any health concern.

- Type: Plugin
- Made by: mitchhankins01
- Category: Health & fitness
- Formats: Local MCP
- Version: 0.1.4
- Source: https://github.com/mitchhankins01/oura-ring-mcp
- Page: https://pluginboard.ai/plugins/oura-ring-mcp

## Works with

- Claude
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- OpenClaw
- OpenCode
- Hermes Agent

## Install

You'll need:

- `OURA_ACCESS_TOKEN` (optional): Oura Personal Access Token (get from cloud.ouraring.com/personal-access-tokens)
- `OURA_CLIENT_ID` (optional): OAuth Client ID (alternative to access token, from developer.ouraring.com)
- `OURA_CLIENT_SECRET` (optional): OAuth Client Secret (required with OURA_CLIENT_ID)

Replace each `<NAME>` placeholder with your own value.

### Claude

Add to claude_desktop_config.json:

```json
{
  "mcpServers": {
    "oura-ring-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "oura-ring-mcp@0.1.4"
      ]
    }
  }
}
```

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22oura-ring-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22oura-ring-mcp%400.1.4%22%5D%7D

Run in your terminal:

```shell
code --add-mcp '{"name":"oura-ring-mcp","command":"npx","args":["-y","oura-ring-mcp@0.1.4"]}'
```

Copilot CLI:

```shell
copilot mcp add oura-ring-mcp -- npx -y oura-ring-mcp@0.1.4
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=oura-ring-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm91cmEtcmluZy1tY3BAMC4xLjQiXX0%3D

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "oura-ring-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "oura-ring-mcp@0.1.4"
      ]
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add oura-ring-mcp -- npx -y oura-ring-mcp@0.1.4
```

### Codex

Run in your terminal:

```shell
codex mcp add oura-ring-mcp -- npx -y oura-ring-mcp@0.1.4
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "oura-ring-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "oura-ring-mcp@0.1.4"
      ]
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add oura-ring-mcp npx -y oura-ring-mcp@0.1.4
```

### OpenClaw

In a terminal: Run openclaw mcp add oura-ring-mcp --command npx, with --arg before each argument (-y oura-ring-mcp@0.1.4) and --env NAME=value for each variable it needs.

### OpenCode

Run in your terminal:

```shell
opencode mcp add oura-ring-mcp -- npx -y oura-ring-mcp@0.1.4
```

### Hermes Agent

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "oura-ring-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "oura-ring-mcp@0.1.4"
      ]
    }
  }
}
```

---
From Pluginboard (https://pluginboard.ai).