SQL과 DuckDB를 사용하여 MCP 클라이언트에서 Apple Health 데이터를 조회합니다. 서버가 실행됩니다 로컬에서는 필요할 때 CSV 내보내기를 읽고, 스키마 발견을 위한 도구를 제공합니다. 분석 쿼리와 건강 요약.

요구 사항

• Node.js 22 이상
• Apple Health CSV 내보내기 자료 간단한 건강 내보내기 CSV

네이티브 Apple Health export.xml 형식은 현재 지원되지 않습니다.

MCP 클라이언트 구성

Claude Desktop의 경우, 다음 내용을 추가하세요 ~/Library/Application Support/Claude/claude_desktop_config.json:

설정을 변경한 후 클라이언트를 재시작하세요. 다른 MCP 클라이언트는 동일한 명령어, 인수, 환경, 그리고 stdio 전송입니다.

환경 변수

건강 데이터 내보내기

1. 아이폰에 Simple Health Export CSV 파일을 설치하고 엽니다.
2. All을 선택하고 내보낼 시간 범위를 선택합니다.
3. 아카이브를 MCP 클라이언트가 실행 중인 컴퓨터로 전송합니다.

Apple Health MCP Server

Query Apple Health data from an MCP client using SQL and DuckDB. The server runs locally, reads CSV exports on demand, and provides tools for schema discovery, analytical queries, and health summaries.

Requirements

• Node.js 22 or newer
• An Apple Health CSV export created with Simple Health Export CSV

The native Apple Health export.xml format is not currently supported.

Configure an MCP client

For Claude Desktop, add the following to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Restart the client after changing its configuration. Other MCP clients can use the same command, arguments, environment, and stdio transport.

Environment variables

Export health data

1. Install and open Simple Health Export CSV on your iPhone.
2. Select All and choose the time range to export.
3. Transfer the archive to the computer running your MCP client.
4. Unzip it and set HEALTH_DATA_DIR to the resulting directory.

The server reads the files in place. It does not upload the export or make network requests, although query results returned to your MCP client may be sent to that client’s configured model provider.

Tools

Start with health_schema; table names depend on the files in your export. See Querying Apple Health data for the data model and working examples.

health_query accepts one DuckDB analytical statement. See Query safeguards for supported statements and restricted operations.

Query safeguards

The server limits DuckDB file access to HEALTH_DATA_DIR. It also disables network access and temporary disk storage, and it locks the database settings.