google-health-chatgpt-selfhost
Google Health ChatGPT Self-host
Eine inoffizielle Referenzimplementierung für den Einzelbenutzerbetrieb, die eine eng begrenzte Menge an Google-Health-Daten aus gewöhnlichen ChatGPT-Unterhaltungen über eine private MCP-Verbindung ausliest.
Dieses Repository enthält Quellcode und eine Bereitstellungsanleitung. Es veröffentlicht oder legt keine bestehenden MCP-Dienste, ChatGPT-Apps, Tunnel, Google-Cloud-Projekte, Zugangsdaten oder Gesundheitsdaten anderer offen. Jede bereitstellende Person erstellt und besitzt ein unabhängiges Google-Cloud-Projekt, einen OAuth-Grant, einen OpenAI-Tunnel, einen Host und eine ChatGPT-App im Developer Mode.
Was das Projekt bietet
Ein Node.js-stdio-MCP-Server mit genau vier Nur-Lese-Tools.
Vier feste Google-Health-OAuth-Scopes mit Nur-Lese-Zugriff.
Feste Datentyp-Zulassungslisten: 32 Reconcile-Arten, 18 Rollup-Arten und IRN-Verlauf.
Vom Server generierte Google-Filter, Validierung geschlossen–offener Intervalle, Begrenzungen der Seitengröße und datenschutzwahrende Feldmasken.
Ein Upstream-Antwortlimit von 90.000 Byte, das bereits beim Streamen der Antwort durchgesetzt wird, bevor der vollständige Antwort-Body gepuffert wird.
Metadaten für das Query-Routing, eingebettet in MCP-Anweisungen, Tool-Beschreibungen und Schemata, damit ChatGPT im Web die richtige Operation auswählen kann, ohne dass eine separate private Ausgangsbasis vorhanden sein muss.
Ein lokaler Skill- und Abfragenkatalog für Entwicklung, Überprüfung und Auswertung. Der Developer Mode importiert diesen Skill nicht automatisch in ChatGPT im Web.
Leitfäden zu Google Cloud OAuth, Linux/systemd, OpenAI Secure MCP Tunnel, ChatGPT, geplanten Tasks, Datenschutz und Fehlerbehandlung.
Related MCP server: fitbridge
Bewusste Grenzen
Dieses Projekt ist für eine private Bereitstellung mit einem einzelnen Benutzer gedacht. Es enthält keine Schreiboperation, keinen öffentlichen MCP-Endpunkt, keine Datenbank, keinen Antwortspeicher-Cache, keine Analyse-Pipeline, keine Mehrbenutzer-Authentifizierung, kein zertifiziertes Paket für das öffentliche Plugin-Verzeichnis und keine Funktion für medizinische Diagnosen. Es ist kein eine medizinische Diagnosefunktion. Es ist kein Medizinprodukt.
Wenn ein Tool ausgeführt wird, gelangt die angeforderte Gesundheitsantwort von Google Health durch den selbst gehosteten Prozess und den Tunnel von OpenAI in die ChatGPT-Unterhaltung. Der Anwendungscode speichert diese Antwort zwar nicht dauerhaft, aber die bereitstellende Person muss die Richtlinien und das Aufbewahrungsverhalten von Google, OpenAI, der Hosting-Plattform und sämtlicher Infrastrukturprotokolle unabhängig verstehen und offenlegen.
Architektur
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.comDer Secure MCP Tunnel hält den MCP-Server vom öffentlichen Internet fern, ist aber eine private Entwicklungsverbindung und kein Weg zur Einreichung eines öffentlichen Plugins.
Nur-Lese-Vertrag
Die OAuth-Berechtigung ist an folgende Bereiche (Scopes) gebunden:
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.readonlyDer MCP-Server stellt folgende Tools zur Verfügung:
Tool | Beabsichtigtes Ergebnis |
| Tageswerte für Kalendertage und Tag-für-Tag-Trends |
| Buckets mit drei oder 5 Minuten, 15 Minuten, 1 Stunde, 6 Stunden oder 24 Stunden |
| Datensätze für Tage, Stichproben, Intervalle, Schlafsitzungen oder Trainingssitzungen |
| Datensätze für Benachrichtigungen zu unregelmäßigem Rhythmus |
Die vollständige Matrix von Datentypen zu Methoden finden Sie in skills/google-health-readonly/references/query-catalog.md.
Bereitstellungspfad
Lesen Sie die unter
docs/architecture-and-scope.mdunddocs/privacy-and-security.md.Konfigurieren Sie ein unabhängiges Google-Cloud-Projekt und einen OAuth-Client mit
docs/google-cloud-oauth.md.Holen Sie die Offline-Erteilung für den einzelnen Benutzer mit
docs/local-offline-grant.mdein.Erstellen und installieren Sie den MCP-Server mit
docs/deploy-linux-systemd.md.Erstellen und ausführen den privaten Tunnel mit
docs/openai-secure-mcp-tunnel.md.Fügen Sie die App im Developer Mode hinzu und weisen Sie sie mit
docs/chatgpt-developer-mode.mdnach.Konfigurieren Sie einen geplanten Task erst nach der interaktiven Freigabe mit
docs/scheduled-task.md.
Legen Sie keinerlei Zugangsdaten in diesem Repository, Chat-Nachrichten, Issues, Befehlszeilenargumente, Screenshots oder CI-Variablen mit absolut $11 million ab. Das Setup verwendet Pfadangaben in Umgebungsvariablen; die Dateien selbst dürfen nur für den Besitzer lesbar sein.
Entwicklung
Voraussetzungen: Node.js 22 oder neuer, npm und Python 3 – und nur nur, wenn Sie den optionalen Codex-Skill-Validator ausführen möchten.
npm ci
npm run check
npm run audit:discovery
npm auditDas Discovery-Prüfung greift ausschließlich auf das öffentliche API-Discover-Dokument von Google zu; es authentifiziert sich nicht und fragt keine Gesundheitsdaten ab. Die Tests gelten mit synthetischen Testdaten.
Falls der Codex-Skill-Validator lokal installiert ist:
python3 /path/to/skill-creator/scripts/quick_validate.py skills/google-health-readonlySie sollten die Datei CONTRIBUTING.md Lesen, bevor Sie Änderungen einreichen. Nehmen Sie niemals echte Gesundheitsdaten, Abfrageergebnisse, Kontokennungen, OAuth-Werte, Tunnel-IDs oder Screenshots aus privaten Steuerungsumfeldern in eine Issue oder einen Pull Request aufsw ge.
Upstream-Richtlinien und Produktverfügbarkeit
Der Zugriff auf die Google-Health-API, die Verifizierung, die Offenlegungsbereiche (Scopes) und das Verhalten von Tokens unterliegt den Regeln von Google. Die Verfügbarkeit und die Berechtigungen von Developer Mode und, falls verfügbar, von Secure MCP Tunnel werden von OpenAI bestimmt und können je nach Konto oder Zugriffsbereich variieren. Prüfen Sie die verlinkte offizielle Dokumentation während der Bereitstellung immer wieder.
Lizenz
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Hosted Apple Health MCP for Claude and ChatGPT, works outside the US. iPhone app, no local server.
Read patient-authorized EHR records: medications, labs, conditions, allergies. Consent-bounded.
Hosted Apple Health MCP: workouts, sleep and HRV in ChatGPT, Claude, Gemini, Grok. Free, no export.
Consent-gated tools that turn user health notes into non-diagnostic appointment-prep materials.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceExposes 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
- AlicenseNot gradedqualityCmaintenanceEnables 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
- AlicenseNot gradedqualityCmaintenanceEnables 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.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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.1AGPL 3.0