Oura MCP server

Oura MCP server

Claude.ai と Claude Code から Oura リングのデータを読み取れます。睡眠スコアの背後にある完全な睡眠期間、レディネス、アクティビティ、ワークアウト、心拍数、ストレス、SpO2、レジリエンス、心血管年齢、VO2 max、就寝時間の提案、タグ、休養モードを扱います。文書化された Oura API v2 と通信し、前面に OAuth 2.1 ログインを配置しているため、Claude.ai にカスタムコネクタとして追加できます。Claude Code では、通常のトークンを代わりに使えます。

npm パッケージを使わない理由

このサーバーは、元々 @daveremy/oura-mcp のラッパーとして始めましたが、そのパッケージは、どこからでも使えますが、問い合わせた内容にはほとんど何も返さないため、置き換えました。これは、単日の範囲を start_date == end_date として扱い、その名前が示す使い方は Oura API が想定している範囲とは一致しません。

• sleep は UTC の bedtime_start でフィルタリングするため、現地時刻(UTC+3)の 00:31 に始まる夜は UTC の前日に落ち、その日の窓の外に出ます

• daily_activity と workout は end_date を排他として扱うため、同じ日を指定した範囲は幅ゼロになります

その結果、静かな失敗が起きます。oura_sleep は空の periods 配列付きのスコアを返し、oura_activity は null を返し、oura_workouts は [] を返します。単日を呼び出すたびにです。何もエラーが出ないため、「クエリが間違っていた」のではなく「データが記録されていない」ように見えます。このサーバーは、範囲を両側に拡張し、各レコードの day フィールドに基づいてフィルタリングして戻すため、タイムゾーンに対して正しく動作します。また、next_token を最後まで追跡するため、黙って1ページだけを返すことはありません。

ツール

日付で絞り込むすべてのツールには、任意の date を YYYY-MM-DD 形式で指定でき、省略時は今日になります。Oura は、夜のデータを起床した日のレコードとして保存します。

oura_vo2_max と oura_sleep_time と oura_cardiovascular_age は、設計上データがまばらです。Oura が毎日ではなく定期的に計算するため、空の結果は正常なことであり、同期の失敗ではありません。

全体の仕組み

Claude.ai / Claude Code
        |  HTTPS
   Cloudflare Tunnel, or any proxy that gives you HTTPS
        |
   nginx  127.0.0.1:8441
        |
   auth-server.js  :8442    handles the login and the tokens
        |
   oura-mcp  :8440          streamable HTTP, local only
        |
   api.ouraring.com

ポート番号は 8440 から 8442 です。このホスト上の他MCPサーバーとは重ならないようにしています。:8440 のサーバーは独自のログインを持たず、ループバック以外にはバインドしないので、ログイン層を経由したときだけ到達できます。

Ｔセットアップ

Python 3.12 以上が必要です。ログイン層には Node も必要です。

python3 -m venv .venv
.venv/bin/pip install -e .
npm install --omit=dev

mkdir -p ~/.config/oura-mcp && chmod 700 ~/.config/oura-mcp
echo "OURA_TOKEN=your-personal-access-token" > ~/.config/oura-mcp/env
chmod 600 ~/.config/oura-mcp/env

CONFIG_DIR=~/.config/oura-mcp node set-password.js 'your-password-here'
openssl rand -hex 32 > ~/.config/oura-mcp/token
chmod 600 ~/.config/oura-mcp/token

Oura のトークンは cloud.ouraring.com から取得してください。

その後、systemd/*.service と nginx/oura-mcp.conf に YOUR_USER とホスト名を書き込み、次を行います：

sudo cp systemd/*.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now oura-mcp oura-mcp-auth
sudo cp nginx/oura-mcp.conf /etc/nginx/sites-enabled/oura-mcp
sudo nginx -t && sudo systemctl reload nginx

127.0.0.1:8441 にトンネルまたは HTTPS プロキシを向けてください。OAuth には HTTPS が必要です。

外部から確認してください。discovery はメタデータを返し、トークンなしの /mcp は 401 を返す必要があります。

curl https://your-host/.well-known/oauth-authorization-server
curl -o /dev/null -w '%{http_code}\n' -X POST https://your-host/mcp

接続

Claude.ai：Settings、Connectors、カスタムコネクタの追加、https://your-host/mcp、クライアントIDとクライアントシークレットは空にします。

Claude Code:

claude mcp add --transport http oura https://your-host/mcp \
  --header "Authorization: Bearer $(cat ~/.config/oura-mcp/token)" --scope user

stdio で実行し、ログイン層を使わない場合は：

OURA_TOKEN=your-token .venv/bin/oura-mcp

クレジット

ログイン層は rollecode/obsidian-remote-mcp の作品です。