Oura Ring (read-only)

Oura Ring MCP サーバー（読み取り専用）

Claude、Cursor、VS Code、または任意のMCPクライアントに、Oura Ringのコンディション、睡眠、HRV、アクティビティ、ストレス、心拍数について質問できます。データを変更する手段を一切与えずに利用できます。

「昨夜の睡眠はどうでしたか？コンディションが64しかないのはなぜですか？」 「過去30日間のHRVと最低心拍数を比較してください。」 「昨夜の睡眠ステージと心拍数の推移を表示してください。」 「アルコールをタグ付けした日の後は、コンディションが下がりますか？」

（インストールの前後に、一度だけauth手順を実行してください。）

このサーバーの特長

• 読み取り専用を徹底。 OuraのAPIにはデータを書き込むエンドポイントがありません。このクライアントはさらに厳格で、GETのみを送信し、/v2/usercollection/以外のURLを拒否します。また、Webhook APIには一切アクセスせず、すべてのツールにreadOnlyHint: trueが設定されています。これらを満たさない場合、テストでビルドが失敗します。
• 質問全体に1回の呼び出しで回答。 get_daily_overviewは、1日分のコンディション、睡眠、昼寝、アクティビティ、ストレス、レジリエンス、SpO2、ワークアウト、タグをまとめて返します。get_trendsは、最大90日分の日別テーブルに加え、平均値とコンディションゾーンを返します。
• モデルに適した出力。 秒やメートルではなく、時間、分、km、現地時刻を使ったコンパクトなJSONを出力します。ヒプノグラムはステージごとのセグメントで、心拍数はバケットごとに集約されます。Ouraの元のオブジェクトが必要な場合は、raw: trueを指定してください。
• 利用できないデータにも柔軟に対応。 Ouraの同意画面でデータタイプのチェックを外している場合、統合ツールは失敗する代わりに、そのデータタイプをunavailableに列挙します。
• トークンはお使いのマシンから外に出ません。 ご自身のOura APIアプリケーション、PKCEによるOAuth、0600のトークンファイルを使用し、Ouraの一度しか使えないリフレッシュトークンを安全に扱います。サードパーティのサーバーもテレメトリーもありません。
• アカウントなしで試せます。 OURA_SANDBOX=1を指定すると、Ouraの公開サンプルデータを利用できます。

クイックスタート

**Node.js 20.11+**とOuraアカウントが必要です。（Ouraは2025年12月に個人用アクセストークンを廃止したため、OAuthのみ利用できます。）

1. Oura APIアプリケーションを作成する（2分）

1. cloud.ouraring.com/oauth/applicationsを開き、新しいアプリケーションを作成します。
2. Redirect URIをhttp://localhost:8787/callbackに設定します。
3. Client IDとClient Secretをコピーします。

Ouraの承認なしで、アプリケーションは最大10人のユーザーに利用できます。個人利用には十分です。

2. Oura アカウントを接続する

npx -y @royreznik/oura-ring-mcp auth

求められたら、クライアント ID とクライアントシークレットを貼り付けます（シークレットは画面に表示されません）。ブラウザーで Oura の同意ページが開くので、すべてのデータ種別にチェックを入れたまま承認してください。トークンは ~/.config/oura-ring-mcp/tokens.json に保存され、以降は自動的に更新されます。

（スクリプトの場合、プロンプトに回答する代わりに OURA_CLIENT_ID と OURA_CLIENT_SECRET を設定してください。）

3. MCP クライアントに追加する

/plugin marketplace add royreznik/oura-ring-mcp
/plugin install oura@oura-ring-mcp

claude mcp add oura --scope user -- npx -y @royreznik/oura-ring-mcp

{
  "mcpServers": {
    "oura": {
      "command": "npx",
      "args": ["-y", "@royreznik/oura-ring-mcp"]
    }
  }
}

{
  "servers": {
    "oura": { "type": "stdio", "command": "npx", "args": ["-y", "@royreznik/oura-ring-mcp"] }
  }
}

[mcp_servers.oura]
command = "npx"
args = ["-y", "@royreznik/oura-ring-mcp"]

docker build -t oura-ring-mcp https://github.com/royreznik/oura-ring-mcp.git
docker run -i --rm -v ~/.config/oura-ring-mcp:/home/node/.config/oura-ring-mcp oura-ring-mcp

次に、「今日の Oura の概要を教えてください」と尋ねます。

アカウントなしで試す

claude mcp add oura-sandbox --env OURA_SANDBOX=1 -- npx -y @royreznik/oura-ring-mcp

サンドボックスモードでは、Oura の公開サンプルデータを利用できます。認証手順は不要で、個人データも使いません。

ツール

リスト取得ツールは start / end（YYYY-MM-DD、両端を含む）、簡易指定の days、および next_token を受け付けます。詳細は**ツールリファレンス**をご覧ください。

設定

oura-ring-mcp            Start the MCP server on stdio (what your MCP client runs)
oura-ring-mcp auth       Connect your Oura account (opens your browser)
oura-ring-mcp status     Check the stored connection
oura-ring-mcp logout     Delete the locally stored tokens
oura-ring-mcp --version

「今日」はコンピューターのタイムゾーンに基づいて算出されます。このタイムゾーンは、Oura アプリで使用しているタイムゾーンと一致している必要があります。

プライバシーとセキュリティ

• oura-ring-mcp は api.ouraring.com とのみ通信します（auth の実行中にブラウザーで cloud.ouraring.com にアクセスする場合を除きます）。テレメトリーや中継サーバーはありません。
• トークンとクライアントシークレットは、ユーザー本人のみが読み取れる（0600）ファイル 1 つに保存されます。ログに記録されたり、ツールから返されたりすることはありません。
• **MCP クライアントは、ツールの結果を言語モデルに送信します。**問い合わせた健康データは、その利用規約に基づいてモデルのプロバイダーと共有されます。
• 接続を解除するには、oura-ring-mcp logout を実行します。アクセス権を完全に取り消すには、cloud.ouraring.com/oauth/applications でアプリケーションを削除するか、Oura アカウントでアクセス権を取り消します。

詳細については、PRIVACY.md と SECURITY.md をご覧ください。

認証の仕組み

• PKCE（S256）とランダムな state を使用する OAuth 2 認可コードフローです。ループバック専用のコールバックサーバーで結果を受け取ります。
• Oura のリフレッシュトークンは 1 回しか使えません。oura-ring-mcp は、有効期限の直前（および 401 の発生時）に、ロックファイルを使って同時に 1 つずつリフレッシュします。これにより、同じマシン上で複数のクライアント（例：Claude Desktop と Claude Code）が同時にリフレッシュするのを防ぎ、新しいトークンをアトミックに書き込みます。書き込みに失敗した場合も、新しいトークンはメモリーに保持されるため、ディスク容量がいっぱいになってもログアウトされません。
• レート制限（429。Retry-After に従います）、サーバーエラー、タイムアウト（30 秒）、ネットワークエラーは、バックオフを適用して再試行されます。クライアントでリクエストをキャンセルすると、Oura への呼び出しも停止します。

トラブルシューティング

npx -y @royreznik/oura-ring-mcp status

開発

npm install
npm test                 # unit, MCP integration, end-to-end and packaging tests (no network)
npm run smoke:sandbox    # every tool against Oura's live sandbox API
npm run smoke:live       # every tool against your account (after auth); prints only counts
npm run inspect          # MCP Inspector

CONTRIBUTING.md をご覧ください。唯一の厳格なルールは、oura-ring-mcp を読み取り専用に保つことです。

クレジットと法的情報

アーキテクチャ、認証、テストの方針は、Oryan Omer による whoop-mcp（MIT）を参考にしています。

MIT © Roy Reznik。非公式プロジェクトであり、Oura Health Oy との提携や同社による承認はありません。「Oura」は Oura Health Oy の商標です。ここに記載されている内容は、医学的助言ではありません。