Apple Health MCP Server

Fragen Sie Apple-Health-Daten über einen MCP-Client mit SQL und DuckDB ab. Der Server läuft lokal, liest CSV-Exporte bei Bedarf und bietet Werkzeuge für Schema-Erkennung, schreibgeschützte Abfragen und Gesundheitszusammenfassungen.

Anforderungen

• Node.js 22 oder neuer

• Ein Apple-Health-CSV-Export, der mit Simple Health Export CSV erstellt wurde

Das native Apple-Health-export.xml-Format wird derzeit nicht unterstützt.

Related MCP server: apple-mcp

MCP-Client konfigurieren

Fügen Sie für Claude Desktop Folgendes zu ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "apple-health": {
      "command": "npx",
      "args": ["-y", "@neiltron/apple-health-mcp"],
      "env": {
        "HEALTH_DATA_DIR": "/path/to/your/unzipped/health-export"
      }
    }
  }
}

Starten Sie den Client nach der Änderung seiner Konfiguration neu. Andere MCP-Clients können denselben Befehl, dieselben Argumente, dieselbe Umgebung und den stdio-Transport verwenden.

Umgebungsvariablen

Gesundheitsdaten exportieren

1. Installieren und öffnen Sie Simple Health Export CSV auf Ihrem iPhone.

2. Wählen Sie Alle und legen Sie den zu exportierenden Zeitraum fest.

3. Übertragen Sie das Archiv auf den Computer, auf dem Ihr MCP-Client läuft.

4. Entpacken Sie es und setzen Sie HEALTH_DATA_DIR auf das resultierende Verzeichnis.

Der Server liest die Dateien direkt. Er lädt den Export nicht hoch und führt keine Netzwerkanfragen durch, obwohl Abfrageergebnisse, die an Ihren MCP-Client zurückgegeben werden, an den konfigurierten Modellanbieter dieses Clients gesendet werden können.

Werkzeuge

Beginnen Sie mit health_schema; die Tabellennamen hängen von den Dateien in Ihrem Export ab. Siehe Abfragen von Apple-Health-Daten für das Datenmodell und funktionierende Beispiele.

Verlauf und Speicher

Die erste Anfrage, die eine Tabelle benötigt, lädt die vollständige CSV-Historie dieser Tabelle. Es gibt kein Datumsfenster, sodass eine Abfrage so weit zurückreichen kann, wie der Export reicht.

Da jedes Werkzeug auf die gesamte konfigurierte Historie zugreifen kann, starten Sie diesen Server nur von einem MCP-Client, dem Sie diese Daten anvertrauen.

Geladene Tabellen werden im Speicher gehalten, und DuckDB erhält das oben beschriebene MAX_MEMORY_MB-Limit. Ungefähr 1 GiB deckt einen mehrjährigen Multi-Tabellen-Export ab, sodass der Standardwert von 2048 MB Spielraum lässt; erhöhen Sie MAX_MEMORY_MB für einen größeren Export. Der Server schreibt Gesundheitszeilen niemals in ein temporäres Verzeichnis auf der Festplatte, sodass ein Export, der nicht in das Limit passt, stattdessen mit einem expliziten Fehler fehlschlägt.

Weitere aktuelle Einschränkungen:

• Nur das CSV-Layout von Simple Health Export wird unterstützt.

• Die DuckDB-Datenbank befindet sich im Speicher und wird für jeden Serverprozess neu aufgebaut, sodass jeder Start die CSV-Dateien neu lädt. Persistenter inkrementeller Import ist geplante zukünftige Arbeit, nicht das aktuelle Verhalten.

• Geräteüberlappung kann zu doppelt erscheinenden Messwerten führen; Abfragen sollten gegebenenfalls sourceName berücksichtigen.

• Gesundheitsberichte fassen aufgezeichnete Daten zusammen und sind keine medizinische Beratung.

Entwicklung

git clone https://github.com/neiltron/apple-health-mcp.git
cd apple-health-mcp
bun install

npm test
npm run typecheck
npm run build

Siehe Architektur für die Code-Struktur, den Datenlebenszyklus und Implementierungsbeschränkungen.

Lizenz

MIT