google-health-fitbit-mcp

Google Health Fitbit MCP

ローカル OAuth を通じて、ご自身の Google Health API データ（Fitbit、Pixel Watch、接続されたパートナーのデータソース）を照会できます。ベータ版。
すべてご自身のマシン上で動作し、認証情報がデバイスの外に出ることはありません。

ローカルで動作する MCP サーバーです。OAuth を通じて、Fitbit トラッカー、Pixel Watch、サポート対象のパートナーのデータソースから、ご自身の Google Health API データを AI エージェントに渡します。

• 1つのコマンドでインストール — npx -y google-health-fitbit-mcp setup
• 次の環境で実行できます Claude Desktop · Claude Code · Cursor · Windsurf · Hermes · OpenClaw — クライアントの例をご覧ください。
• ご自身のマシン上で動作 — OAuth トークンはローカルに 0600 の権限で保存され、どのツールからも返されることはありません（プライバシー）。
• デフォルトは読み取り専用 — 提供されるデータツールはすべて読み取り専用です。書き込み機能は、明示的な有効化が必要で、ドライランを優先する設計となっており、現在は有効になっていません。

ベータ版の状況： Google Health API は開発者向けに提供されていますが、仕様はまだ変更され続けています。Google のリリースノートには公開後もスコープやデータ型の変更が記載されているため、このコネクターはベータ版のままとし、本番環境で使用する前に、安全な読み取り専用の検証を行うようテスターに推奨しています。

独立したコミュニティ開発のコネクターです。Google、Fitbit、Alphabet との提携、推奨、サポートを受けていません。医療機器ではなく、医療上の助言を提供するものでもありません。データは傾向を把握するための参考情報としてのみご利用ください。

⚡ クイック接続

前提条件：Google Cloud OAuth クライアント（種類：デスクトップ）で、Google Health API が有効になっており、リダイレクト http://127.0.0.1:3000/callback が登録されていること。詳細はインストールを参照してください。

ステップ 1 — インストールと認証（初回のみ）：

npx -y google-health-fitbit-mcp setup     # guided: Google Cloud OAuth client + scopes
npx -y google-health-fitbit-mcp auth      # browser OAuth — tokens stay on your machine
npx -y google-health-fitbit-mcp checkup   # ✓ verifies everything is ready

ステップ 2 — アプリを接続：

claude mcp add google-health -- npx -y google-health-fitbit-mcp

{
  "mcpServers": {
    "google_health": {
      "command": "npx",
      "args": ["-y", "google-health-fitbit-mcp"]
    }
  }
}

{
  "mcpServers": {
    "google_health": {
      "command": "npx",
      "args": ["-y", "google-health-fitbit-mcp"]
    }
  }
}

npx -y google-health-fitbit-mcp setup --client hermes   # writes the Hermes config for you

ステップ 3 — テストします。 エージェントに次のように尋ねてください。

Run google_health_connection_status and tell me if I'm connected.

これが存在する理由

Google Health API は Fitbit Web API の後継です。新しい OAuth、新しいベース URL（https://health.googleapis.com）、簡素化されたエンドポイントスキーマ、標準化された kebab-case のデータタイプ、複数ソースのストリームの統合、日次および身体活動時間の集計を備えています。

エージェントが API を調べ、セットアップを検証し、ローカルでサインインしてデータを取得できる、シンプルな方法を提供します。トークンをプロンプトやエージェント設定に貼り付ける必要はありません。

エージェントで試す

このコネクターに実際に含まれるツールを使った、最初に試すのに適したプロンプトを 3 つ紹介します。

Check my setup with google_health_connection_status, then call
google_health_data_inventory and tell me which Google Health
domains and scopes I've granted.

Pull today's google_health_daily_summary, then google_health_weekly_summary.
Keep observed data separate from any suggestions, and stay non-medical.

List my paired devices with google_health_list_paired_devices and tell me
which device is producing my sleep and heart-rate data.

ツール

ツールは 29 個あり、以下に記載されている、明示的に制限されたローカルプロフィール／認証アクションの 2 つを除き、すべて読み取り専用です。

まずはこちら

データの読み取り（Google Health API）

サマリーとウェルネスのコンテキスト

認証、診断、メタデータ

google_health_get_auth_url · google_health_exchange_code（ゲート付き：ユーザーの明示的な意図が必要） · google_health_revoke_access（ゲート付きかつ破壊的：Google Health との接続を解除します） · google_health_privacy_audit · google_health_cache_status · google_health_data_type_coverage · google_health_capabilities · google_health_agent_manifest · google_health_onboarding · google_health_profile_get · google_health_profile_update（ローカルファイルのみ。explicit_user_intent=true が必要）

リソースとプロンプト

MCP リソース：google-health://agent-manifest、google-health://capabilities、google-health://inventory、google-health://latest/steps、google-health://profile、google-health://summary/daily、google-health://summary/weekly。

MCP プロンプト：google_health_daily_checkin、google_health_weekly_review、google_health_data_type_investigation。

データ型

公式の Google Health テーブルにある39種類のデータ型です。steps、sleep、heart-rate、heart-rate-variability、daily-resting-heart-rate、active-zone-minutes、distance、total-calories、weight、body-fat、blood-glucose、oxygen-saturation、vo2-max、electrocardiogram、irregular-rhythm-notification、exercise、floors、swim-lengths-data、nutrition-log、hydration-log などがあります。

エージェントが知っておく必要のある命名規則：

• エンドポイントでは、ケバブケースのデータ型を使用します：steps、daily-resting-heart-rate。
• フィルターでは、スネークケースのフィールドパスを使用します：sleep.interval.civil_start_time、heart_rate.sample_time.physical_time。
• ソースファミリー：all-sources、google-wearables、google-sources。

単位、スコープ、および各型が対応する動詞（list/reconcile/rollup）を含む完全なカタログを確認するには、google_health_list_data_types を呼び出してください。

プライバシーとオフラインで実行される処理

• OAuth トークンは ~/.google-health-mcp/tokens.json に保存され、アクセス権限は 0600 に制限されます。
• クライアントシークレットは ~/.google-health-mcp/config.json または GOOGLE_HEALTH_* 環境変数に保存します。
• どのツールもアクセストークン、リフレッシュトークン、クライアントシークレットを返すことはありません。エラー出力も秘匿化されます。
• デフォルトのプライバシーモードは GOOGLE_HEALTH_PRIVACY_MODE=structured です。summary では識別情報がさらに取り除かれ、raw はデバッグ用の明示的なオプトインです。
• GPS／ルートデータは機密情報として扱われ、明示的にリクエストされない限り秘匿化されます。
• support は、GitHub の Issue にコピー＆ペーストできるサポート用バンドルを出力します。常に秘匿化され、トークン、シークレット、ローカルパス、健康測定値は含まれません。
• support --feedback --json は、ベータテスター向けの匿名セットアップフィードバック用バンドルを出力します（ガイド）。
• coverage --live --json は、秘匿化されたデータ型のステータスとデータポイント数の区分のみを出力します。Google Health の生データは出力しません（ガイド）。

インストール

Google Cloud OAuth クライアント（種類：Desktop）をセットアップし、Google Health API を有効にして、ローカルリダイレクトを登録します。

http://127.0.0.1:3000/callback

次に、以下を実行します。

npx -y google-health-fitbit-mcp setup --scope-preset full
npx -y google-health-fitbit-mcp auth
npx -y google-health-fitbit-mcp checkup

スコープのプリセット

プリセットを使うと、用途に必要なものだけをリクエストでき、OAuth の同意内容を把握しやすくなります。

上級ユーザーは --scopes に、スペースまたはカンマで区切ったスコープのリストを明示的に指定できます。

セットアップで問題が発生した場合

npx -y google-health-fitbit-mcp checkup --fix        # repairs local config/token permissions (chmod 600 where supported)
npx -y google-health-fitbit-mcp checkup --live       # hits read-only identity/profile/settings endpoints to confirm the API responds
npx -y google-health-fitbit-mcp coverage --live --json  # redacted read-only data-type coverage report
npx -y google-health-fitbit-mcp support             # shareable support bundle, stripped of tokens/secrets/measurements
npx -y google-health-fitbit-mcp support --feedback --json  # anonymous setup feedback bundle

接続を維持する

アクセストークンはバックグラウンドで自動的に更新されます。期限切れになるのは、その更新に使われるリフレッシュトークンです。同意画面の公開ステータスが Testing の間は、Google によって 7 日後に取り消され、次の呼び出しは invalid_grant を返します。再試行しても解決できません。許可はすでに無効になっており、新たに認証し直す必要があります。

そこで、サーバーが代わりに認証を行います。許可が取り消された状態で初めて呼び出すと、Google の同意画面がブラウザーで開きます。承認すると、元のリクエストは自動的に完了します。実行するコマンドも、原因を調べる作業も必要ありません。GOOGLE_HEALTH_REAUTH_WAIT_MS（デフォルトは 45 秒）を超えて時間がかかった場合、呼び出しは代わりに URL を返し、リスナーは起動したままになります。そのため、後から承認しても認証でき、次のリクエストは正常に処理されます。

これは、ブラウザーとサーバーが同じマシン上にあるローカルの stdio トランスポートでのみ動作します。サーバーがリモートにある可能性があり、デフォルトポートがループバックリダイレクトと競合する HTTP トランスポートでは、auth を実行するよう明示するエラーが返されます。再認証を常に自分で行うには GOOGLE_HEALTH_AUTO_REAUTH=0 を設定します。ヘッドレスホストでブラウザーを起動せずに URL を取得するには、GOOGLE_HEALTH_AUTH_NO_BROWSER=1 を設定します。

MCP クライアントの設定

Claude Desktop／Cursor／Windsurf（examples/ を参照）：

{
  "mcpServers": {
    "google_health": {
      "command": "npx",
      "args": ["-y", "google-health-fitbit-mcp"]
    }
  }
}

Hermes

npx -y google-health-fitbit-mcp setup --client hermes --no-auth
npx -y google-health-fitbit-mcp auth
npx -y google-health-fitbit-mcp checkup --client hermes

設定を変更したら、/reload-mcp または hermes mcp test google_health を実行します。データを読み取るだけなら、ゲートウェイを再起動する必要はありません。

HTTP トランスポート（任意）

デフォルトのトランスポートは stdio です。必要とするクライアント向けに、ローカルの Streamable-HTTP トランスポートを利用できます。

npx -y google-health-fitbit-mcp --http   # serves http://127.0.0.1:3000/mcp (+ /health)

設定

信頼性を組み込み済みです。Google へのすべての呼び出しは、リトライミドルウェア（指数バックオフ＋ジッター、Retry-After を尊重し、408/429/5xx を再試行）と、GET のみを対象とする 60 秒のレスポンスキャッシュを経由します。複数日にわたるサマリーでは、レート制限を超えないようリクエストの同時実行数を制限します。

CLI コマンド

すべてのコマンドは npx -y google-health-fitbit-mcp <command> で実行します（インストール済みバイナリ：google-health-fitbit-mcp-server）。

ベータテスター募集中

現在、最も価値のある貢献は、実際の Fitbit、Pixel Watch、Android、Google Health API アカウントを使ったセットアップの実地フィードバックです。

実際のアカウントでテストできる場合は、次の手順をお試しください。

• npx -y google-health-fitbit-mcp checkup を実行し、OAuth フローが分かりやすいかお知らせください。
• npx -y google-health-fitbit-mcp support --feedback --json を実行し、匿名バンドルを GitHub の課題に投稿してください。
• OAuth の完了後、npx -y google-health-fitbit-mcp coverage --live --json を実行し、内容を確認してから、情報を秘匿したカバレッジレポートを投稿してください。
• MCP クライアント内から google_health_connection_status、google_health_data_inventory、google_health_daily_summary を試してください。
• データ型の不足、分かりにくいセットアップ手順、クライアント固有の使いにくさ、プライバシー上の懸念があれば、課題を報告してください。
• OAuth トークン、クライアントシークレット、ローカルパス、個人の健康測定値は、公開の課題に決して記載しないでください。

開発

git clone https://github.com/BerkKilicoglu/google-health-fitbit-mcp.git
cd google-health-fitbit-mcp
npm install
npm test

npm test を実行すると、型チェック、ビルド、MCP スモークテスト（stdio + HTTP）、サマリーフィクスチャ、プライバシー／キャッシュ／リトライのテストスイート、CLI の UX チェック、メタデータの検証が実行されます。ガイドラインについてはCONTRIBUTING.md、セキュリティポリシーについてはSECURITY.mdをご覧ください。

リンク

• Google Health API：https://developers.google.com/health
• リリースノート：https://developers.google.com/health/release-notes
• REST リファレンス：https://developers.google.com/health/reference/rest
• スコープ：https://developers.google.com/health/scopes
• データ型：https://developers.google.com/health/data-types
• 移行ガイド（Fitbit → Google Health）：https://developers.google.com/health/migration

お問い合わせとサポート

• 🐛 バグ報告／機能リクエスト — GitHub Issues
• 📨 [email protected] — 一般的な質問や連携に関するサポート

ライセンス

MIT — LICENSEをご覧ください。