Health.md로 시작하세요.

현재 이용 가능 · 서명된 Mac 도우미

휴대폰에서 건강 데이터를 내보내거나, 서명된 Mac 도우미를 통해 로컬 에이전트를 연결하거나, 버전이 지정된 계약을 기반으로 구축하세요. HealthKit 읽기는 iPhone에서, Health Connect 읽기는 Android에서 이루어집니다.

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

다른 위치에 설치했나요? Mac용 Health.md → CLI에서 번들 도우미 경로를 복사하세요.

첫 iPhone 내보내기 에이전트 연결 계약 살펴보기

01 · 내보내기iPhone에서 시작Apple Health 접근을 허용하고, 폴더를 선택하고, 출력을 미리 본 다음 첫 내보내기를 실행하세요. 02 · 질문로컬 에이전트 연결Codex, Claude 또는 다른 stdio 클라이언트에서 서명된 Mac MCP 도우미를 사용하세요. 03 · 구축안정적인 계약 사용스키마, 레코드, 증거, 생성된 픽스처 및 정확한 엔벨로프를 통합하세요.

21번들 Mac MCP 도구

4내보내기 형식

v8Apple 공개 내보내기 스키마

0필수 Health.md 클라우드 경유 횟수

현재 이용 가능 · macOS

5분 만에 로컬 에이전트 시작하기

Mac에서 Health.md를 연 다음, 페어링된 iPhone에서 Health.md를 열고 연결될 때까지 기다리세요. 번들 도우미는 건강 값을 반환하지 않고 준비 상태를 확인하고, 수면 측정 항목을 나열하며, 하루 범위의 쿼리를 실행합니다.

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

준비가 완료된 doctor 결과는 healthmd.cli_doctor 스키마를 사용하며, 설정이 완료되지 않은 경우 다음 작업을 포함합니다. Codex 또는 Claude를 사용하려면 에이전트 구성으로 이동하여 별도의 서명된 healthmd-mcp 도우미를 클라이언트에 지정하세요.

목표별 선택

구성 및 연결

현재 이용 가능 · Mac구성 — Codex, Claude 또는 다른 stdio 클라이언트를 서명된 MCP 도우미에 연결하세요. 현재 이용 가능 · MacMCP 서버 및 앱 — 번들로 포함된 21개 도구를 살펴보고, 비공개 시각화를 렌더링하며, 이식 가능한 미리보기를 이해하세요. 현재 이용 가능 · MacHealth.md CLI — 번들 도우미를 설치하고, 준비 상태를 검사하고, 데이터를 쿼리하며, 이식 가능한 미리보기를 구분하세요. 아키텍처에이전트 컨텍스트 — 요청 범위, 로컬 신뢰, 암호화된 컨텍스트, 증거, 보존 및 개인정보 보호를 알아보세요.

일상 작업

쿼리, 추출 및 자동화

타입 지정 쿼리측정 항목, 수면 세션, 운동, 비교, 데이터 범위 및 사실 기반 증거를 요청하세요. 미리보기 · 이식 가능한 CLI휴대전화 직접 액세스 — 수동 IP 또는 Tailscale 페어링과 현재 미검증 iPhone/Android 호환성 매트릭스를 확인하세요. 소스 데이터정규 추출 — 선택한 스키마 v8 일별 데이터, 소스 레코드, 프로젝션 또는 JSONL을 가져오세요. 신뢰할 수 있는 실행영속 작업 — 시간 초과, 알 수 없는 결과, 재개, 취소 및 부분 결과를 안전하게 처리하세요. 저수준루프백 API — 정확한 쿼리, 증거, 커서, 새로 고침 및 영속 작업 경로를 사용하세요. 패턴통합 레시피 — 계약을 약화하지 않고 Health.md 출력을 구문 분석하고 검증하세요.

안정적인 인터페이스

데이터 계약 및 구조

계약 맵내보내기 참조 — 스키마, 측정 항목, 형식, 레코드 및 상호 운용성 픽스처를 살펴보세요. 자동화API 및 CLI 계약 — 엔벨로프, 경로, 종료 동작 및 생성된 예제를 검사하세요. 에이전트 결과쿼리 및 증거 — 타입이 지정된 값, 데이터 범위, 누락 상태, 작업 및 결정론적 식별자를 확인하세요. 스키마 v8일별 레코드 — 공개 소스 문서와 그 소유권 규칙을 이해하세요. 용어측정 항목 레지스트리 — 안정적인 크로스 플랫폼 측정 항목 ID, 카테고리, 단위 및 프로필 메타데이터를 사용하세요. 기계 판독 가능생성된 아티팩트 — 정규 필드, 픽스처, 메시지 인벤토리 및 CLI 계약을 여세요.

제품 워크플로

앱 및 내보내기

신뢰할 수 있는 프로필 기반 내보내기

• 요약 또는 공통 상세 시계열을 선택하세요. 정규 무손실 아카이브는 Apple 전용입니다.
• 독립된 설정, 대상 및 일정을 iPhone 또는 Android의 기기 로컬 프로필로 저장하세요.
• 중지 또는 취소는 활성 시도에만 적용됩니다. 완료 날짜는 유지되고 미해결 날짜는 재시도할 수 있으며 일정은 활성화됩니다.

안정 ID, 자동화, 대상 기록 및 안전한 실패는 내보내기 프로필에서 확인하세요.

재사용 가능한 워크플로내보내기 프로필 — 대상, 형식, 측정 항목, 일정 및 자동화 ID를 고정합니다. 여기에서 시작 · iPhone첫 내보내기 — Apple Health 접근을 허용하고, 폴더를 선택하고, 출력을 미리 보고, 작성된 파일을 확인하세요. AndroidHealth Connect — 문서 제공자 폴더를 선택하고 플랫폼 자동화를 구성하세요. 파일내보내기 — Markdown, CSV, JSON 또는 Obsidian Bases로 명시적인 날짜 범위를 실행하세요. 구조형식 사용자 정의 — 단위, 날짜, 프론트매터, 파일 이름 및 쓰기 동작을 제어하세요. 백그라운드예약 — 반복 주기, 복구 및 플랫폼별 시간 제한을 이해하세요. 자동화단축어 및 App Intents — Apple 워크플로에서 내보내기, 요약 및 상태 확인을 실행하세요.

문서 구조 업데이트: 2026-08-31