Oura Ring MCP

🚀 Oura MCP Server

OuraリングをClaudeや他のAIアシスタントに接続するMCPサーバーです。睡眠、レディネス、アクティビティに関する人間が読みやすい洞察を得ることができ、生のJSONデータだけでなく、より詳細な情報を提供します。

✨ 主な機能

• スマートなフォーマット - 時間を時間/分で表示し、スコアにコンテキストを付与します（「85 - 最適」）。
• 睡眠分析 - 睡眠段階、睡眠効率、HRV、生体計測データを分析します。
• レディネス追跡 - 回復スコアとその要因の内訳を提供します。
• アクティビティデータ - 歩数、消費カロリー、強度の内訳を表示します。
• 健康指標 - 心拍数、SpO2、ストレス、心血管年齢を提供します。
• スマート分析 - 異常検出、相関分析、トレンド分析を行います。
• タグサポート - 条件付き/無しで指標を比較できます。

出力例を見る — Claudeが睡眠、レディネス、週次サマリー、スマート分析に対して返す内容を確認できます。

🚀 クイックスタート

1. インストール

npm install -g oura-ring-mcp

または、npxを直接使用してインストールなしで実行できます。

npx oura-ring-mcp

2. Ouraで認証

オプションA: パーソナルアクセストークン（簡単な方法）

1. cloud.ouraring.com/personal-access-tokensにアクセスします。
2. 新しいトークンを作成します。
3. Claude Desktopの設定で OURA_ACCESS_TOKEN を設定します（下記参照）。

オプションB: OAuth CLIフロー

1. developer.ouraring.comでOAuthアプリを作成します。
   • リダイレクトURIを http://localhost:3000/callback に設定します。
2. 認証フローを実行します。

   export OURA_CLIENT_ID=your_client_id
   export OURA_CLIENT_SECRET=your_client_secret
   npx oura-ring-mcp auth
   

3. 認証情報は ~/.oura-mcp/credentials.json に保存されます。

3. Claude Desktopを設定

claude_desktop_config.json に以下を追加します。

パーソナルアクセストークンを使用する場合

{
  "mcpServers": {
    "oura": {
      "command": "npx",
      "args": ["oura-ring-mcp"],
      "env": {
        "OURA_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

OAuthを使用する場合（npx oura-ring-mcp auth を実行した後）

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

サーバーは ~/.oura-mcp/credentials.json から認証情報を読み取ります。トークンの自動更新を有効にするには、OAuth認証情報を追加します。

{
  "mcpServers": {
    "oura": {
      "command": "npx",
      "args": ["oura-ring-mcp"],
      "env": {
        "OURA_CLIENT_ID": "your_client_id",
        "OURA_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

Claude Desktopを再起動します。Node >=18が必要です。

何を尋ねることができますか？

日次チェックイン

• "昨夜はどんな睡眠だった？"
• "今日は十分に回復してトレーニングできるか？"
• "今、私の体は何を教えている？"

パターンとトレンド

• "週末の方が睡眠が良いか？"
• "最適な睡眠のために何時に寝るべきか？"
• "HRVは改善しているか、低下しているか？"

相関と洞察

• "アルコールは睡眠の質に影響するか？"
• "最良の睡眠の夜を予測する要因は何か？"
• "運動のタイミングは回復にどう影響するか？"

比較

• "今週と先週の睡眠を比較して"
• "瞑想後と瞑想なしでの睡眠はどう違うか？"
• "マグネシウムを摂り始めてから何が変わったか？"

異常

• "データに異常な読み取り値はあるか？"
• "昨日のレディネスが低かったのはなぜ？"
• "指標が外れていた日を見つけて"

📦 利用可能なツール

データ取得

スマート分析

リソース

プロンプト

リモートデプロイメント (Railway)

MCPサーバーをリモートでアクセスできるようにデプロイします。サーバーはOuraを介してOAuthをプロキシするため、ユーザーは直接Ouraアカウントで認証できます — PATは必要ありません。

1. Oura OAuthアプリを作成

1. Oura OAuth Applicationsにアクセスします。
2. 新しいアプリケーションを作成します。
3. リダイレクトURI を https://your-app.railway.app/oauth/callback に設定します。
4. クライアントID と クライアントシークレット をメモします。

2. デプロイ

# Railway CLIをインストール
npm install -g @railway/cli

# ログイン、初期化、デプロイ
railway login
railway init
railway up

3. 環境変数を設定

Railwayダッシュボードで以下を追加します。

Railwayは自動的に PORT と RAILWAY_PUBLIC_DOMAIN を設定します。

4. Claude.aiから接続

Claude.aiの コネクター を使用します。

1. 設定 > MCPコネクター > 追加 をクリックします。
2. サーバーURLを入力します: https://your-app.railway.app（/mcp は不要）。
3. OAuthクライアントIDとシークレットを空白のままにします（動的登録が処理します）。
4. Ouraにリダイレクトされ、データへのアクセスを承認します。

5. Claude Desktopから接続

Claude Desktopでは、MCP_SECRET + OURA_ACCESS_TOKEN を使用します。

{
  "mcpServers": {
    "oura-remote": {
      "url": "https://your-app.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer your_mcp_secret_here"
      }
    }
  }
}

ローカルテスト

# Oura OAuthを使用する場合（完全なフロー）
OURA_CLIENT_ID=your_id OURA_CLIENT_SECRET=your_secret pnpm start:http

# 静的シークレットのみを使用する場合（OURA_ACCESS_TOKENが必要）
OURA_ACCESS_TOKEN=your_pat MCP_SECRET=test-secret pnpm start:http

# ヘルスエンドポイントを確認
curl http://localhost:3000/health

# OAuthメタデータを確認（OURA_CLIENT_IDが設定されている場合のみ利用可能）
curl http://localhost:3000/.well-known/oauth-authorization-server

# 認証済みリクエストをテスト（静的シークレットを使用）
curl -X POST http://localhost:3000/mcp \
  -H "Authorization: Bearer test-secret" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{"capabilities":{}},"id":1}'

コントリビュートについて

アーキテクチャの詳細と開発ガイドラインについては、CLAUDE.md を参照してください。

📄 ライセンス

MIT