Skip to main content
Glama
google-health-chatgpt-selfhost

google-health-chatgpt-selfhost

by paceaitian

Google Health ChatGPT Self-host

Google Healthのうち厳しく限定されたデータ群を、プライベートなMCP接続を通じて通常のChatGPTとの会話から読み取るための、非公式の単一ユーザー向けリファレンス実装です。

このリポジトリは、ソースコードとデプロイガイドです。既存のMCPサービス、ChatGPTアプリ、トンネル、Google Cloudプロジェクト、認証情報、健康データを公開・外部にさらすものではありません。デプロイする各人は、独立したGoogle Cloudプロジェクト、OAuth認可、OpenAIトンネル、ホスト、ChatGPT Developer Modeアプリを作成して所有します。

提供内容

  • 読み取り専用ツールをちょうど4つ備えた、Node.jsのstdio MCPサーバー。

  • Google Healthの読み取り専用OAuthスコープ4つに固定。

  • データ型の許可リストを固定: reconcileタイプ32種、rollupタイプ18種、IRN履歴。

  • サーバー生成のGoogleフィルター、半開区間(closed-open)の範囲検証、ページサイズ上限、プライバシーを保護するフィールドマスク。

  • レスポンスのストリーミング中、全体をバッファリングする前に強制される、90,000バイトの上流レスポンス上限。

  • クエリルーティング用メタデータをMCPインストラクション、ツール説明、スキーマに埋め込み、web ChatGPTだけで、別途プライベートベースラインを用意しなくても正しい操作を選択できるようにする。

  • 開発・レビュー・評価のためのローカルなSkillとクエリカタログ。Developer ModeはこのSkillをweb ChatGPTに自動インポートしません。

  • Google Cloud OAuth、Linux/systemd、OpenAI Secure MCP Tunnel、ChatGPT、Scheduled task、プライバシー、トラブルシューティングの各ガイド。

Related MCP server: fitbridge

意図的な境界

このプロジェクトは、プライベートな単一ユーザーによるデプロイを想定しています。書き込み操作、公開MCPエンドポイント、データベース、レスポンスキャッシュ、アナリティクスパイプライン、マルチユーザー認証、公開のPlugin Directoryパッケージ、医療診断機能はありません。また、医療機器ではありません。

ツールが実行されると、要求されたヘルスレスポンスはGoogle Healthからセルフト・ホストのプロセス、OpenAIのトンネルを経てChatGPTの会話に届きます。アプリケーションコードはそのレスポンスを永続化しませんが、デプロイする人はGoogle、OpenAI、ホスティングプラットフォーム、および各インフラストラクチャのログに関するポリシーと保持の扱いを別途理解し、開示する必要があります。

アーキテクチャ

ChatGPT conversation or Scheduled task
                |
      private Developer Mode app
                |
       OpenAI Secure MCP Tunnel
        outbound HTTPS only
                |
          tunnel-client host
                |
         stdio Node.js MCP
                |
     Google OAuth refresh on demand
                |
       health.googleapis.com

Secure MCP TunnelはMCPサーバーをパブリックインターネットにさらしません。ただし、これはプライベートな開発用接続であり、公開プラグインの提出経路ではありません。

読み取り専用の契約

OAuthの認可は次のスコープに固定されます:

https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly
https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly
https://www.googleapis.com/auth/googlehealth.irn.readonly
https://www.googleapis.com/auth/googlehealth.sleep.readonly

MCPサーバーが公開するのは次のとおりです:

ツール

取得できる結果

google_health_daily_rollup

暦日単位の合計と日ごとのトレンド

google_health_physical_rollup

5分、15分、1時間、6時間、24時間のバケット

google_health_reconcile

日次、サンプル、区間、睡眠・運動セッションのレコード

google_health_irn_list

不規則心拍の通知レコード

タイプとメソッドの対応マトリクス全体は、skills/google-health-readonly/references/query-catalog.mdにあります。

デプロイ手順

  1. docs/architecture-and-scope.md と docs/privacy-and-security.md を読んで、設計との境界を把握する。

  2. docs/google-cloud-oauth.md に従い、独立的なGoogle CloudプロジェクトとOAuthクライアントを設定する。

  3. docs/local-offline-grant.md に従い、単一ユーザー向けオフライン認可を取得する。

  4. docs/deploy-linux-systemd.md に従い、MCPサーバーをビルドしインストールする。

  5. docs/openai-secure-mcp-tunnel.md に従い、プライベートトンネルを作成して実行する。

  6. docs/chatgpt-developer-mode.md に従い、Developer Modeアプリを作成して検証する。

  7. 対話的に受諾を確認した後にだけ、docs/scheduled-task.md に従って定期タスクを構成する。

認証情報をこのリポジトリ、チャットのメッセージ、イシューレポート、コマンドライン引数、スクリーンショット、CI変数内に置かないでください。セットアップでは環境変数にファイルパスを示し、そのファイル自体は所有者のみアクセスできる権限にします。

開発

要件: Node.js 22以降。npm。オプションのCodexスキルバリデータを実行する場合のみPython 3が必要です。

npm ci
npm run check
npm run audit:discovery
npm audit

ディスカバリテストはGoogleの公開APIディスカバリドキュメントにのみ接触し、認証や健康データへのクエリは行いません。テストスイートは合成フィクスチャを使用します。

Codexスキルバリデータをローカルにインストールしている場合:

python3 /path/to/skill-creator/scripts/quick_validate.py skills/google-health-readonly

変更を送信する前に、必ず CONTRIBUTING.md を参照してください。実際の健康データ、クエリ結果、アカウント識別子、OAuthの値、トンネルID、個人管理画面のスクリーンショットを、機能・プルリクエストには決して含めないでください。

上流ポリシーと製品の利用可否

Google Health APIへのアクセス、検証、スコープ、トークンの挙動はGoogleが管理します。Developer Modeアプリ版やSecure MCP Tunnelの利用可否・権限は、お客様のアカウントや Organizationworkspaceによって異なる場合があります。デプロイ中は常に必ず、リンクされた公式ドキュメントを再確認してください。

ライセンス

Apache License 2.0です。LICENSE と NOTICE を参照してください。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Exposes Apple Health data as three read-only MCP tools (current status, details, trends) via a Cloudflare Worker, enabling AI assistants to view health metrics without modification.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables ChatGPT and Claude to access Android Health Connect records through nine read-only MCP tools for overviews, daily summaries, sleep, workouts, intraday series, trends, correlation, search, and fetch.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables ChatGPT and other MCP clients to securely read Health Connect-derived health and training history, retrieve daily readiness and workout briefs, save schema-validated coach reports, and trigger email delivery through OAuth-protected tools.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI apps to query a user's Google Health data—such as sleep, heart rate, HRV, activity, and paired devices—through read-only tools deployed privately in the user's own Firebase project.
      1
      AGPL 3.0