Bien démarrer avec Health.md

Disponible maintenant · utilitaire Mac signé

Exportez les données de santé de votre téléphone, connectez un agent local à l’aide des utilitaires Mac signés ou développez à partir de contrats versionnés. Les lectures HealthKit restent sur l’iPhone et les lectures Health Connect sur Android.

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

L’application est installée ailleurs ? Copiez le chemin de l’utilitaire intégré depuis Health.md for Mac → CLI.

Premier export depuis l’iPhone Connecter un agent Parcourir les contrats

01 · ExporterCommencez sur l’iPhoneAutorisez Apple Health, choisissez un dossier, prévisualisez le résultat et lancez un premier export. 02 · InterrogerConnectez un agent localUtilisez l’utilitaire MCP Mac signé avec Codex, Claude ou un autre client stdio. 03 · DévelopperUtilisez des contrats stablesIntégrez des schémas, des enregistrements, des preuves, des fixtures générées et des enveloppes exactes.

21outils MCP Mac intégrés

4formats d’export

v8schéma public d’export Apple

0passage obligatoire par un cloud Health.md

Disponible maintenant · macOS

Démarrage rapide d’un agent local en cinq minutes

Ouvrez Health.md sur le Mac, puis Health.md sur l’iPhone jumelé, et attendez que la connexion soit établie. L’utilitaire intégré vérifie que tout est prêt sans renvoyer de valeurs de santé, répertorie les métriques de sommeil et exécute une requête sur une journée :

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

Lorsque tout est prêt, le résultat de doctor utilise le schéma healthmd.cli_doctor et indique les étapes suivantes si la configuration est incomplète. Pour Codex ou Claude, poursuivez avec Configurer votre agent et dirigez le client vers l’utilitaire signé distinct healthmd-mcp.

Choisissez selon votre objectif

Configurer et connecter

Disponible maintenant · MacConfiguration — connectez Codex, Claude ou un autre client stdio à l’utilitaire MCP signé. Disponible maintenant · MacServeur MCP et App — découvrez les 21 outils intégrés, affichez des visualisations privées et comprenez l’aperçu portable. Disponible maintenant · MacCLI Health.md — installez l’utilitaire intégré, vérifiez son état, interrogez les données et distinguez l’aperçu portable. ArchitectureContexte de l’agent — découvrez la portée des requêtes, la confiance locale, le contexte chiffré, les preuves, la conservation et la confidentialité.

Opérations courantes

Interroger, extraire et automatiser

Requêtes typéesInterrogez les métriques, les sessions de sommeil, les entraînements, les comparaisons, la couverture et les preuves factuelles. Aperçu · CLI portableAccès direct au téléphone — consultez le jumelage par IP manuelle ou Tailscale et la matrice actuelle de compatibilité iPhone/Android non qualifiée. Données sourcesExtraction canonique — récupérez les jours sélectionnés au schéma v8, les enregistrements sources, les projections ou le JSONL. Exécutions fiablesTâches persistantes — gérez en toute sécurité les délais d’attente, les résultats incertains, la reprise, l’annulation et les résultats partiels. Bas niveauAPI en boucle locale — utilisez les routes exactes de requête, de preuve, de curseur, d’actualisation et de tâches persistantes. ModèlesRecettes d’intégration — analysez et validez les résultats Health.md sans affaiblir leurs contrats.

Interfaces stables

Contrats et structures de données

Carte des contratsRéférence des exports — parcourez les schémas, métriques, formats, enregistrements et fixtures d’interopérabilité. AutomatisationContrats API et CLI — examinez les enveloppes, les routes, le comportement de sortie et les exemples générés. Résultats de l’agentRequêtes et preuves — valeurs typées, couverture, données manquantes, opérations et identités déterministes. Schéma v8Enregistrements quotidiens — comprenez le document source public et ses règles de propriété. VocabulaireRegistre des métriques — utilisez des ID de métriques, catégories, unités et métadonnées de profil stables sur toutes les plateformes. Lisible par machineArtefacts générés — consultez les champs canoniques, fixtures, inventaires de messages et contrats CLI.

Flux de travail du produit

Applications et exports

Exports fiables basés sur des profils

• Choisissez Résumé ou Série chronologique détaillée commune ; l’archive canonique sans perte est réservée à Apple.
• Enregistrez réglages, destinations et planifications indépendants dans des profils locaux sur iPhone ou Android.
• Arrêter ou annuler ne touche que la tentative active : dates terminées conservées, autres réessayables et planifications toujours actives.

Commencez par Profils d’exportation pour les identifiants stables, l’automatisation, l’historique des destinations et l’échec sûr.

Flux réutilisablesProfils d’exportation — figez la destination, les formats, les métriques, la planification et l’identifiant d’automatisation. Commencez ici · iPhonePremier export — autorisez Apple Health, choisissez un dossier, prévisualisez le résultat et vérifiez les fichiers écrits. AndroidHealth Connect — choisissez un dossier de fournisseur de documents et configurez l’automatisation de la plateforme. FichiersExport — exécutez des plages de dates explicites au format Markdown, CSV, JSON ou Obsidian Bases. StructurePersonnalisation du format — contrôlez les unités, les dates, le frontmatter, les noms de fichiers et le comportement d’écriture. Arrière-planPlanification — comprenez les cadences récurrentes, la récupération et les limites temporelles de chaque plateforme. AutomatisationShortcuts et App Intents — déclenchez des exports, des résumés et des vérifications d’état depuis les flux de travail Apple.

Structure de la documentation mise à jour le 2026-08-31