如何导出 Apple Health 数据:真正管用的所有方法
你的 iPhone 和手表里有多年的健康数据,而 Apple 只给了你一种导出方式。本指南先如实介绍这种方式,再介绍绕过它局限的办法:CSV、定时导出、你自己的服务器,以及面向 AI 智能体的实时访问。下面提到的应用里有一个是我们开发的,提到时我们会注明。
1. Apple 内置的导出(免费,一个大 XML 文件)
- 打开健康应用
- 点按右上角你的头像或姓名首字母
- 向下滚动,点按导出所有健康数据,然后确认
- 等待(有多年数据时要几分钟),然后分享
export.zip
里面是 export.xml:Apple 拥有的每一条样本,这是好的一面。其余就是它的缺陷。它是一个可能大到几个 GB 的文件,是 XML,电子表格打不开,无法定时导出,无法只导出某一项指标,也无法只获取自上次以来有变化的部分。它是完整备份,不是数据管道。作为一次性存档,它没问题,而且不花钱。
2. 改用 CSV
有两条路。一是转换 XML 导出文件:我们的免费浏览器内转换器可以不上传任何内容,就把 export.zip 转成 CSV 和 JSON(每日总计、睡眠、训练、原始记录),喜欢写代码的话,用脚本也能做到。无论哪种方式,每次想要新数据都得重新导出整个存档。二是用直接读取 HealthKit 的应用,按指标写出 CSV。Marrow(我们的,免费)通过共享面板导出 CSV、JSON 和 GPX,可以只导一项指标,也可以全部导出。Health Auto Export 的手动 CSV 导出免费,自动化则需要订阅。
3. Apple Health 没有服务器 API
值得直说,因为这正是大家在找的东西:HealthKit 只存在于设备上。没有云端端点,没有 OAuth,你的服务器没有任何可以调用的东西。凡是离开手机的数据,都是因为手机上的某个应用把它发出去的。所以“自动导出”指的永远是一个拥有后台权限的应用,把数据推送到你选定的地方。
这个限制同时也是隐私上的好处:除非你安装了会往外发送的东西,否则什么都不会离开手机,而且你能清楚地看到数据去了哪里。
4. 定时的自动导出
如果是给仪表板、Home Assistant、n8n 或你自己的数据库用,你需要的是按计划推送到你指定的 URL。Marrow 免费做到这一点,借助后台同步,应用关闭时导出也照常运行(n8n、Home Assistant 和你自己的服务器的 webhook 设置)。Health Auto Export 开创了这个品类,做得也很好,定时自动化在它的 Premium 档。两者都能把 JSON 或 CSV 发送到任意 webhook。
5. 在你自己的硬件上保留完整镜像
最强的数据所有权:在你掌控的机器上保存一份实时更新的完整副本。Marrow 可以与运行在树莓派、NAS 或旧笔记本上的自托管服务器(一个 Python 文件,采用 MIT 许可)配对。手机在后台让它保持最新。镜像是 SQLite,所以可以直接查询。
6. 让 AI 智能体读取它(MCP)
最新的方式,也是很多人真正想要的:不是文件,而是一个能根据真实数据回答“我开始晨练之后,睡眠有什么变化?”的助手。这要通过 MCP(Model Context Protocol)实现。Marrow 在 iPhone 上直接运行一个 MCP 服务器,免费,七个只读工具。自托管镜像也支持 MCP,所以手机休眠时智能体也能查询它。如果你用 ChatGPT、Claude 或 Gemini,又不想自己运行任何东西,Cloud MCP(Marrow Pro)可以替你托管这个镜像。Health Auto Export 也提供 MCP 服务器,而且出现得更早,但它需要 Premium。Claude、Cursor 或任意 MCP 客户端的设置方法:两步指南.
训练和路线:导出 GPX
训练的 GPS 路线值得单独说一说,因为 Apple 的 XML 导出把它们作为单独的 GPX 文件,每次训练一个,埋在存档深处。如果你只想要某一次跑步的路线,而不想搞一场考古,就用应用按训练导出 GPX。Marrow 会显示每次训练及其路线,并按需分享 GPX。
逐组的力量训练明细也类似:它存在于 HealthKit 里,但大多数导出工具会把它压平丢掉,所以值得检查你选的工具是否保留了你在意的内容。
坦诚的对比
| 内置导出 | Health Auto Export | Marrow | |
|---|---|---|---|
| 价格 | 免费 | $2.99 至 $24.99。自动化和 MCP 属于 Premium | 免费 |
| 格式 | 一个 XML 存档(内含 GPX) | CSV、JSON | CSV、JSON、GPX |
| 定时推送 | 否 | Premium | 免费 |
| 自托管镜像 | 否 | 否 | 免费,开源 |
| AI 智能体(MCP) | 否 | Premium | 免费,在设备上 |
| 最适合 | 一次性的完整存档 | 老牌导出工具,格式选项丰富 | 持续的数据管道和智能体访问 |
数据于 2026 年 8 月对照各厂商自己的页面核对。如果这里有哪些已经过时,请告诉我们,我们会修正。做一个准确的页面,就是我们全部的策略。
简短版本
- 一次性存档:用 Apple 内置的导出,如果需要电子表格,就用浏览器内转换器把它转成 CSV。
- 持续导出 CSV:用导出类应用。先看清它的免费档究竟包含什么。
- 你自己的数据库或仪表板:用定时 webhook 或自托管镜像。
- 一个了解你健康状况的 AI:用 MCP,在 Marrow 里只要两步,而且免费。所有方案的对比见 Apple Health MCP 服务器.