withingsmcp

ローカル

wellness.delx.aiヘルスケア53 週間前に更新

withingsmcp について

withingsmcpは、Withingsアカウントのデータを使う個人向け健康ワークフロー用のローカル優先MCPサーバーです。OAuthをローカルで処理し、身体測定、睡眠、活動、心臓関連の記録にアクセスできます。トークンは端末外へ送信されません。

主な機能

01身体測定と体組成データの照会
02睡眠サマリーと詳細記録の取得
03活動・ワークアウト記録の表示
04心臓関連記録へのアクセス
05OAuthとプライバシー設定のローカル処理

活用シーン

01週ごとの体重と睡眠傾向の確認
02毎日の活動と身体データの要約
03体組成と睡眠の変化の調査

MCP 対応

WithingsデータをMCPツール、プロンプト、リソースとして互換クライアントに公開します。標準ではstdioを使い、ループバック限定のHTTPにも対応します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "davidmosiah-withingsmcp": {
      "command": "npx",
      "args": [
        "-y",
        "withings-mcp-unofficial"
      ],
      "env": {
        "WITHINGS_CLIENT_ID": "<WITHINGS_CLIENT_ID>",
        "WITHINGS_CLIENT_SECRET": "<WITHINGS_CLIENT_SECRET>",
        "WITHINGS_REDIRECT_URI": "<WITHINGS_REDIRECT_URI>",
        "WITHINGS_TOKEN_PATH": "<WITHINGS_TOKEN_PATH>",
        "WITHINGS_PRIVACY_MODE": "<WITHINGS_PRIVACY_MODE>",
        "WITHINGS_CACHE": "<WITHINGS_CACHE>",
        "WITHINGS_CACHE_PATH": "<WITHINGS_CACHE_PATH>",
        "WITHINGS_NO_CACHE": "<WITHINGS_NO_CACHE>"
      }
    }
  }
}

起動コマンドnpx -y withings-mcp-unofficial

設定が必要な環境変数

WITHINGS_CLIENT_IDWithings OAuth client ID. Optional when configured with withings-mcp-server setup.

WITHINGS_CLIENT_SECRETシークレットWithings OAuth client secret. Prefer withings-mcp-server setup so this secret is stored in ~/.withings-mcp/config.json instead of MCP client config.

WITHINGS_REDIRECT_URIRedirect URI configured in the Withings Developer Dashboard. Optional when configured with withings-mcp-server setup.

WITHINGS_TOKEN_PATHシークレットOptional local path for OAuth tokens. Defaults to ~/.withings-mcp/tokens.json.

WITHINGS_PRIVACY_MODEOptional payload mode: summary, structured, or raw. Defaults to structured. raw means full Withings API payloads, not continuous 24/7 raw sensor telemetry.

WITHINGS_CACHEOptional SQLite cache toggle. Set to true or sqlite to enable.

WITHINGS_CACHE_PATHOptional local SQLite cache path. Defaults to ~/.withings-mcp/cache.sqlite.

WITHINGS_NO_CACHESet to true to bypass the in-memory HTTP response cache (60s TTL for GET only). POST/PUT/DELETE and 4xx/5xx responses are never cached regardless. Note: Withings's wbsapi.withings.net is POST-only today, so this is currently a no-op.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npmwithings-mcp-unofficial0.4.7stdio

ツール

掲載時のツール一覧 · 2 週間前に更新

パラメーター	型	必須	説明
response_format	enum	いいえ	markdown \| json

詳細

Withings MCP

Withings の体組成、睡眠、アクティビティ、心臓のデータを AI エージェントに提供します — ローカルで。
ローカルファーストの MCP サーバー — トークンがマシンの外に出ることはありません。

⚡ Delx Wellness for Hermesでワンコマンドインストールできます： npx -y delx-wellness-hermes setup — このコネクターとほかの8つを、専用の Hermes プロファイルに事前設定します。

または、Claude Desktop／Cursor／ChatGPT Desktop に単独で組み込むこともできます — 詳しくは以下のインストールセクションをご覧ください。

HTTP（v2 ステートレス）

デフォルトはstdioです。オプションの Streamable HTTP — セッション ID なし、JSON レスポンス、ループバックのみ：

npx -y withings-mcp-unofficial --http
# GET  http://127.0.0.1:3000/health
# POST http://127.0.0.1:3000/mcp   (sessionless)

環境変数：WITHINGS_MCP_HOST、WITHINGS_MCP_PORT、WITHINGS_MCP_TRANSPORT=http。

AI エージェントを Withings の体組成、睡眠、アクティビティ、心臓のデータに接続する、ローカルファーストの MCP サーバーです。

非公式プロジェクトです。 Withings との提携、同社による承認またはサポートはありません。Withings は各所有者の商標です。ご自身の Withings アカウントでのみ使用し、Withings Public API の利用規約に従ってください。

David Mosiahが、Claude、Cursor、Hermes、OpenClaw などの MCP 互換エージェントを使って、Withings アプリから数値をコピー＆ペーストせずに、体組成、睡眠、長期的な健康傾向について考えたい方のために開発しました。

ローカルファーストのウェルネス MCP コネクターのレジストリ、Delx Wellnessの一部です。

このコネクターがエージェントのワークフローに役立ったら、リポジトリにスターを付けてください。スターが増えると、ほかの AI 開発者がこのプロジェクトを見つけやすくなり、Delx がローカルファーストのウェルネス基盤を提供し続ける助けになります。

これが必要な理由

Withings は、消費者向けの体組成・睡眠エコシステム（スマート体重計、Sleep Analyzer、ScanWatch）を最も長く展開しています。データは豊富です。定期的に測定される体重＋体脂肪＋筋肉量、睡眠ステージ、ECG グレードの心臓記録などが含まれます。ただし、Withings Public API は署名付きトークンを使う OAuth フローを採用しており、一般的な消費者向け API よりも手順が複雑です。

このパッケージは、署名付き OAuth の一連の処理をローカルで行い、レスポンスを正規化して、Model Context Protocol 経由で Withings を利用できるようにします。トークンがマシンの外に出ることはありません。プライバシーモードのデフォルトでは、生のペイロードは明示的に有効にした場合のみ利用できます。

60 秒でセットアップ

リダイレクト URI を http://127.0.0.1:3000/callback に設定した Withings アプリが必要です（こちらから作成）。

npx -y withings-mcp-unofficial setup    # interactive: paste client id + secret
npx -y withings-mcp-unofficial auth     # opens browser, captures the OAuth code
npx -y withings-mcp-unofficial doctor   # verifies you're ready

推奨スコープ：

user.activity user.metrics

次に、これを MCP クライアントの設定に追加します。

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

Claude Desktop の場合は、setup --client claude を実行すると、スニペットが自動的に書き込まれます。

注： Withings の OAuth 認証コードは有効期間が短く（数分）、同意画面で承認してから withings_exchange_code が実行されるまでの間に時間を置かないでください。

エージェントで試す

まずは、次の 3 つを尋ねてみてください。

Use withings_connection_status to check setup, then run withings_daily_summary.
Give me a 5-line wellness brief for today.

Call withings_weekly_summary with response_format=json. Identify my biggest
sleep/body bottleneck and give me a next-week plan.

Use the withings_body_sleep_investigation prompt, after=2026-04-01.
Walk me through what changed in body composition + sleep.

データの利用可否

このパッケージは公式の Withings Public API を使用します。この README で raw と記載している場合、対応エンドポイントの上流にある Withings JSON を指し、デバイスの生のセンサーストリームを意味するものではありません。

データ	利用可否	備考
体組成測定値（体重、体脂肪率、筋肉量、骨量、水分量）	✓	`user.metrics` スコープが必要です
日次アクティビティ（歩数、カロリー、距離、運動強度）	✓	`user.activity` スコープが必要です
ワークアウト＋スポーツのメタデータ	✓	`user.activity` スコープが必要です
睡眠の概要（時間、ステージ、効率、HR）	✓	`user.activity` スコープが必要です
詳細な睡眠記録	✓	デバイスが公開している場合に利用できます
心臓の記録（ECG、BP など）	✓	`user.metrics` スコープが必要です。デバイスやプランによって異なります
継続的なセンサーテレメトリ	—	Withings Public API では公開されていません

ツール

まずはこちらをお試しください：

withings_connection_status — Withings を呼び出す前に、ローカルのセットアップを確認します
withings_data_inventory — Withings API を呼び出さずに、対応するデータ領域、スコープ、プライバシーモード、おすすめの最初の呼び出しを一覧表示します。
withings_daily_summary — 今日の体組成、睡眠、アクティビティ、心臓の概要
withings_weekly_summary — スコアカード、前週との比較、翌週の計画

認証と診断

withings_capabilities、withings_agent_manifest、withings_privacy_audit、withings_cache_status
withings_get_auth_url、withings_exchange_code、withings_revoke_access

体組成と測定値

withings_list_body_measures — 定期的に記録された体重・体組成の測定値。大量の履歴を取得する場合は、after / before に YYYY-MM-DD または ISO 8601 を指定してください。サーバーは上流に Withings の startdate / enddate（Unix 秒）を送信し、返される記録数を limit で制限します。
日付フィルターはアクションに応じて処理されます。getactivity / getworkouts / 睡眠の getsummary では、暦日ベースの startdateymd / enddateymd を送信します。getmeas、睡眠の詳細、心臓の一覧では、エポック形式の startdate / enddate が使われます。エポック形式のアクションでは、オフセット付き ISO 時刻は正確なエポック変換が維持されます。
withings_list_heart — デバイスやプランが対応している場合に心臓の記録を取得します

アクティビティ

withings_list_activity — 日次アクティビティの概要
withings_list_workouts — 記録されたワークアウト

睡眠

withings_list_sleep_summary — HR／ステージのフィールドを含む日次睡眠の概要
withings_list_sleep — 詳細な睡眠記録

プロンプト

withings_daily_checkin — 実用的な日次の健康・体組成チェックイン
withings_weekly_review — 体組成、睡眠、アクティビティの傾向を振り返ります
withings_body_sleep_investigation — 体組成の測定値と睡眠をまとめて調査します

リソース

withings://capabilities、withings://agent-manifest
withings://latest/activity、withings://latest/sleep
withings://summary/daily、withings://summary/weekly

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

OAuth トークンは ~/.withings-mcp/tokens.json に 0600 権限で保存され、ツールから返されることはありません。
Withings は署名付きリクエストを使用する OAuth フローを採用しています。パッケージがローカルで署名を処理するため、クライアントシークレットが MCP クライアントに渡ることはありません。
サーバーがアクセストークンやリフレッシュトークンを出力することはありません。
WITHINGS_PRIVACY_MODE のデフォルトは structured です。生の Withings JSON は、raw モードまたは呼び出しごとのオーバーライドでのみ取得できます。
構造化モードでは、今後 Withings に追加されるものも含め、生理学的データの上流のフィールドをすべて保持しながら、GPS とシークレットを含む値を削除します。
withings_revoke_access はローカルトークンを消去します。アカウント側のトークンを完全に失効できるかどうかは、Withings のプランによって異なります。
MCP クライアントがアクセストークンやリフレッシュトークンを参照することはありません。
これは医療上の助言ではありません。Withings は ECG や血圧など、医療信号に似たデータを公開しますが、このサーバーは個人向けの AI ワークフロー用であり、診断や治療を目的としたものではありません。

設定

setup は、これらの大半を ~/.withings-mcp/config.json（0600）に書き込みます。環境変数による手動の上書きにも対応しています。

WITHINGS_CLIENT_ID=…
WITHINGS_CLIENT_SECRET=…
WITHINGS_REDIRECT_URI=http://127.0.0.1:3000/callback

# Optional
WITHINGS_SCOPES="user.activity user.metrics"
WITHINGS_PRIVACY_MODE=structured        # summary | structured | raw
WITHINGS_CACHE=sqlite                   # optional read-through cache
WITHINGS_TOKEN_PATH=~/.withings-mcp/tokens.json
WITHINGS_CACHE_PATH=~/.withings-mcp/cache.sqlite

Hermes／リモート設定

npx -y withings-mcp-unofficial setup --client hermes --no-auth
npx -y withings-mcp-unofficial auth                      # run locally if browser auth is needed
npx -y withings-mcp-unofficial doctor --client hermes
hermes mcp test withings

Hermes の設定を変更した後は、/reload-mcp または hermes mcp test withings を使用してください。通常のデータアクセスでは、ゲートウェイを再起動する必要はありません。

ブラウザーでの OAuth 認証を Hermes とは別のマシンで行う必要がある場合は、ローカルで auth を実行し、~/.withings-mcp/tokens.json を chmod 600 を指定してサーバーにコピーしてください。

要件

Node.js 20+
https://account.withings.com/partner/dashboard_oauth2 にある Withings アプリと、リダイレクト URI http://127.0.0.1:3000/callback

開発

git clone https://github.com/davidmosiah/withings-mcp.git
cd withings-mcp
npm install
npm test
npm run build

MCP Inspector でテストします。

npx @modelcontextprotocol/inspector node dist/index.js

リンク

npm：https://www.npmjs.com/package/withings-mcp-unofficial
ドキュメントサイト：https://wellness.delx.ai/connectors/withings
旧ドキュメント：https://withingsmcp.vercel.app/
GitHub：https://github.com/davidmosiah/withings-mcp
Delx Wellness レジストリ：https://github.com/davidmosiah/delx-wellness
コネクター品質基準：https://github.com/davidmosiah/delx-wellness/blob/main/docs/connector-quality-standard.md
Withings Public API ドキュメント：https://developer.withings.com/api-reference/

📧 お問い合わせとサポート

📨 [email protected] — 一般的な質問、連携に関するサポート、パートナーシップ
🐛 バグ報告／機能リクエスト — GitHub Issues
🐦 最新情報 — X の @delx369
🌐 サイト — wellness.delx.ai

ライセンス

MIT — LICENSE をご覧ください。

免責事項

このソフトウェアは現状有姿で提供されます。医療機器ではなく、医療上の助言を提供するものでもありません。また、診断や治療に使用しないでください。Withings は、医療信号に類似する可能性のあるデータ（ECG、血圧、体組成）を公開しています。健康上の懸念については、必ず資格を持つ専門家にご相談ください。

スキルまたは MCP

同じパッケージを、2 つの方法で利用できます。MCP は stdio／HTTP でツールを登録します。スキルを使えば、クライアントが MCP に対応していない場合でも、CLI を通じて同じツールを操作できます。

npx -y withings-mcp-unofficial call withings_connection_status --json '{}'

skill/SKILL.md をエージェントのスキルディレクトリにコピーしてください。

Markdown 対応

ログインしてコメント

基本情報

作者: davidmosiah
言語: node
バージョン: 0.4.7
トランスポート: stdio
掲載日: 2026年7月3日
最終更新: 3 週間前
公式 Registry: io.github.davidmosiah/withingsmcp

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

プロバイダー	パッケージ	リポジトリ
WHOOP	`whoop-mcp-unofficial`	whoop-mcp
Oura	`oura-mcp-unofficial`	ouramcp
Garmin	`garmin-mcp-unofficial`	garminmcp
Strava	`strava-mcp-unofficial`	strava-mcp
Fitbit	`fitbit-mcp-unofficial`	fitbitmcp
Withings	`withings-mcp-unofficial`	withings-mcp
Apple Health	`apple-health-mcp-unofficial`	apple-health-mcp
Polar	`polar-mcp-unofficial`	polarmcp
Nourish（栄養）	`wellness-nourish`	wellness-nourish