withings-mcp

OAuth、ローカルSQLiteキャッシュ、トレンド分析機能を備えたWithings Health API用MCPサーバーです。

他のWithings MCPサーバーとの違い:

• 高速なオフラインクエリと過去のトレンド分析のためのローカルSQLiteキャッシュ

• 増分同期 - 前回の同期以降の新しいデータのみを取得

• 200種類以上のすべてのWithings測定タイプをサポート（体組成、睡眠、アクティビティ、ワークアウト、ECG）

• 自動OAuthトークン更新（アクセストークン: 3時間、リフレッシュトークン: 1年）

• mcp以外の依存関係なし（HTTPは標準ライブラリを使用）

• Python 3.13+対応

ツール

Related MCP server: Withings MCP Server

前提条件

• Python 3.13+

• uv（推奨）または pip

• Withings開発者アカウントおよび登録済みアプリケーション

インストール

git clone https://github.com/partymola/withings-mcp.git
cd withings-mcp
uv venv --python 3.13 .venv
uv pip install -e .

セットアップ

1. Withingsアプリの登録

1. https://developer.withings.com/dashboard にアクセス

2. 新しいアプリケーションを作成

3. コールバックURLを http://localhost:8585 に設定

4. クライアントIDとクライアントシークレットを控える

2. 認証

.venv/bin/withings-mcp auth

これによりブラウザが開き、Withingsの認証が行われます。承認後、トークンはローカルの config/ ディレクトリに保存されます。

3. Claude Codeへの登録

claude mcp add -s user withings -- /path/to/withings-mcp/.venv/bin/withings-mcp

4. 初回同期

Claude Codeで「Sync my Withings data」と入力してください。

これにより withings_sync が実行され、ローカルキャッシュが作成されます。以降の同期では新しいデータのみが取得されます。

設定

プロンプト例

• 「Sync my Withings data」（Withingsデータを同期して）

• 「Show my weight for the last 3 months」（過去3ヶ月の体重を表示して）

• 「How has my sleep changed this year?」（今年の睡眠はどう変化した？）

• 「Compare my body composition this month vs last month」（今月と先月の体組成を比較して）

• 「What workouts did I do in March?」（3月にはどんなワークアウトをした？）

• 「What Withings devices do I have connected?」（接続されているWithingsデバイスは何？）

• 「Show my sleep trends quarterly」（四半期ごとの睡眠トレンドを表示して）

開発

# Install with dev dependencies
uv pip install -e . && uv pip install pytest

# Run tests (74 tests, all use in-memory SQLite with fictional data)
.venv/bin/python -m pytest tests/ -v

セキュリティ

• 読み取り専用: Withingsサーバー上のデータを変更するツールはありません

• ローカルストレージ: 健康データはローカルのSQLiteデータベース内にのみ保持されます

• トークンストレージ: OAuthトークンは config/ に保存されます（gitignored、ファイル権限は0600）

• エラーメッセージ: 健康データの値は含まれず、ステータスコードのみが表示されます

• プリコミットフック: データベースファイルや認証情報がコミットされるのを防ぎます

コントリビューション

開発環境のセットアップ、テストワークフロー、プリコミットフックについては CONTRIBUTING.md を参照してください。変更履歴は CHANGELOG.md で管理されています。

ライセンス

GPL-3.0-or-later