Oura Mcp Unofficial

Name: Oura Mcp Unofficial
Author: davidmosiah

@davidmosiah

代码仓库主页

关于 Oura Mcp Unofficial

Local-first MCP server for Oura Ring readiness, sleep, HRV — Claude/Cursor/ChatGPT ready

基本信息

分类

AI 与智能体

许可证

MIT

运行时

node

传输方式

stdio

发布者

davidmosiah

提交者

David Batista

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

realistic synthetic readiness/sleep/activity payloads (no account needed; see [Quickstart](#quickstart-see-the-data-before-you-connect))

personalized 3-step setup walkthrough that adapts to your current state

verify local setup before calling Oura

inventory supported data domains, scopes, privacy modes and recommended first calls without calling Oura APIs.

readiness, sleep, activity and SpO2 brief for today

scorecard, comparison vs prior week, next-week plan

概览

What is Oura Mcp Unofficial?

Oura Mcp Unofficial is a local-first MCP server that connects AI agents to your Oura Ring data — readiness scores, sleep stages, HRV, activity, SpO2, and personal info — without needing to copy-paste from the Oura app. It handles the OAuth dance locally, normalizes responses across endpoints, and exposes Oura through the Model Context Protocol. Tokens never leave your machine, and raw payloads are opt-in via privacy-mode defaults.

How to use Oura Mcp Unofficial?

First create an Oura app at cloud.ouraring.com with redirect URI http://127.0.0.1:3000/callback. Then run npx -y oura-mcp-unofficial setup (paste client id + secret), npx -y oura-mcp-unofficial auth (opens browser for OAuth), and npx -y oura-mcp-unofficial doctor to verify. Add the server to your MCP client config as a npx command, or for Claude Desktop run setup --client claude to auto-write the snippet. You can also call oura_demo before connecting to see synthetic payloads.

Key features of Oura Mcp Unofficial

Local-first: OAuth tokens never leave your machine
Supports readiness, sleep, activity, HRV, SpO2, workouts, sessions, tags, personal info
Privacy‑mode defaults to structured; raw JSON is opt‑in
Demo mode (oura_demo) works without an Oura account
Includes prompts like oura_daily_checkin and oura_weekly_review
Caching opt‑in via SQLite; configurable via env or ~/.oura-mcp/config.json
Compatible with Hermes‑based remote setups

Use cases of Oura Mcp Unofficial

Get a daily readiness and sleep brief for your AI agent to plan workouts or rest
Review weekly trends across sleep, HRV, and activity with a next‑week plan
Investigate heart‑rate records without exposing raw data
Let your agent evaluate recovery before recommending training intensity
Set up a private wellness agent using Claude Desktop, Cursor, or Hermes

FAQ from Oura Mcp Unofficial

What data can Oura Mcp Unofficial access?

It can access daily readiness scores, daily sleep scores with sleep periods (stages, timing), daily activity (steps, calories, MET), heart‑rate time series, HRV via readiness contributors, SpO2 daily averages, workouts, sessions, tags, and personal info (DOB, sex, height, weight) — subject to scopes granted in the Oura Cloud API. Continuous sensor telemetry is not available.

What are the requirements to run Oura Mcp Unofficial?

You need Node.js 20+ and an Oura app created at cloud.ouraring.com with the redirect URI set to http://127.0.0.1:3000/callback.

How do I verify my setup?

Run oura_connection_status in your agent after completing setup and auth. You can also use oura_doctor from the command line to confirm everything is ready.

Is my Oura token secure?

Yes. OAuth tokens are stored in ~/.oura-mcp/tokens.json with Unix permissions 0600. The server never prints or returns access/refresh tokens to the MCP client.

Is this an official Oura product?

No. This is an unofficial project not affiliated with, endorsed by, or supported by Ōura Health Oy. Use it only with your own Oura account and in line with the Oura Cloud API terms.