Inizia con Health.md.

Disponibile ora · helper firmato per Mac

Esporta i dati sanitari dal telefono, collega un agente locale tramite gli helper firmati per Mac oppure sviluppa utilizzando contratti versionati. Le letture di HealthKit restano sull’iPhone e quelle di Health Connect restano su Android.

$ "/Applications/Health.md.app/Contents/Helpers/healthmd" doctor

Installato altrove? Copia il percorso dell’helper incluso da Health.md per Mac → CLI.

Prima esportazione da iPhone Collega un agente Esplora i contratti

01 · EsportaInizia su iPhoneAutorizza Apple Health, scegli una cartella, visualizza l’anteprima del risultato ed esegui la prima esportazione. 02 · ChiediCollega un agente localeUsa l’helper MCP firmato per Mac con Codex, Claude o un altro client stdio. 03 · SviluppaUsa contratti stabiliIntegra schemi, record, evidenze, fixture generate e involucri esatti.

21strumenti MCP inclusi per Mac

4formati di esportazione

v8schema pubblico di esportazione Apple

0passaggi obbligatori attraverso il cloud di Health.md

Disponibile ora · macOS

Avvio rapido in cinque minuti con un agente locale

Apri Health.md sul Mac, quindi apri Health.md sull’iPhone abbinato e attendi che venga stabilita la connessione. L’helper incluso verifica che tutto sia pronto senza restituire valori sanitari, elenca le metriche del sonno ed esegue una query relativa a un giorno:

HMD="/Applications/Health.md.app/Contents/Helpers/healthmd"
"$HMD" doctor
"$HMD" metrics list --category Sleep
"$HMD" query --category Sleep --yesterday

Quando tutto è pronto, il risultato di doctor usa lo schema healthmd.cli_doctor e include le azioni successive se la configurazione è incompleta. Per Codex o Claude, prosegui con Configura il tuo agente e configura il client affinché utilizzi l’helper firmato separato healthmd-mcp.

Scegli in base all’obiettivo

Configurazione e connessione

Disponibile ora · MacConfigurazione — collega Codex, Claude o un altro client stdio all’helper MCP firmato. Disponibile ora · MacServer MCP e app — scopri 21 strumenti inclusi, genera visualizzazioni private e scopri l’anteprima multipiattaforma. Disponibile ora · MacCLI di Health.md — installa l’helper incluso, verifica che tutto sia pronto, interroga i dati e distingui l’anteprima multipiattaforma. ArchitetturaContesto dell’agente — scopri l’ambito delle richieste, l’attendibilità locale, il contesto crittografato, le evidenze, la conservazione e la privacy.

Operazioni quotidiane

Interrogazione, estrazione e automazione

Query tipizzateRichiedi metriche, sessioni di sonno, allenamenti, confronti, copertura ed evidenze fattuali. Anteprima · CLI multipiattaformaAccesso diretto al telefono — consulta l’abbinamento tramite IP manuale o Tailscale e l’attuale matrice di compatibilità iPhone/Android non qualificata. Dati di origineEstrazione canonica — acquisisci giorni selezionati dello schema v8, record di origine, proiezioni o JSONL. Esecuzioni affidabiliAttività persistenti — gestisci in modo sicuro timeout, esiti sconosciuti, ripresa, annullamento e risultati parziali. Basso livelloAPI di loopback — usa route esatte per query, evidenze, cursori, aggiornamenti e attività persistenti. ModelliRicette di integrazione — analizza e convalida i risultati di Health.md senza indebolirne i contratti.

Interfacce stabili

Contratti e strutture dei dati

Mappa dei contrattiRiferimento per l’esportazione — consulta schemi, metriche, formati, record e fixture di interoperabilità. AutomazioneContratti API e CLI — esamina involucri, route, comportamento di uscita ed esempi generati. Risultati dell’agenteQuery ed evidenze — valori tipizzati, copertura, dati mancanti, operazioni e identità deterministiche. Schema v8Record giornalieri — comprendi il documento di origine pubblico e le relative regole di titolarità. VocabolarioRegistro delle metriche — usa ID, categorie, unità e metadati del profilo stabili e multipiattaforma. Leggibile dalle macchineArtefatti generati — consulta campi canonici, fixture, inventari dei messaggi e contratti CLI.

Flussi di lavoro del prodotto

App ed esportazioni

Esportazioni affidabili basate sui profili

• Scegli Riepilogo o Serie temporale dettagliata condivisa; l’archivio canonico senza perdita è solo Apple.
• Salva impostazioni, destinazioni e pianificazioni indipendenti in profili locali su iPhone o Android.
• Interrompere o annullare riguarda solo il tentativo attivo: le date completate restano, le altre sono riprovabili e le pianificazioni attive.

Inizia da Profili di esportazione per ID stabili, automazione, cronologia delle destinazioni e fallimenti sicuri.

Flussi riutilizzabiliProfili di esportazione — fissa destinazione, formati, metriche, pianificazione e ID di automazione. Inizia qui · iPhonePrima esportazione — autorizza Apple Health, scegli una cartella, visualizza l’anteprima del risultato e verifica i file scritti. AndroidHealth Connect — scegli una cartella tramite un provider di documenti e configura l’automazione della piattaforma. FileEsportazione — esegui intervalli di date espliciti in Markdown, CSV, JSON o Obsidian Bases. StrutturaPersonalizzazione del formato — controlla unità, date, frontmatter, nomi dei file e comportamento di scrittura. In backgroundProgrammazione — comprendi le cadenze ricorrenti, il recupero e i limiti temporali della piattaforma. AutomazioneComandi rapidi e App Intents — avvia esportazioni, riepiloghi e controlli dello stato dai flussi di lavoro Apple.

Struttura della documentazione aggiornata il 2026-08-31