Apple Health Shortcuts MCP

Turn Apple Health data into 3 tools that AI can view read-only.

This is an independent, from-scratch open-source project. It doesn't rely on paid health export apps, nor does it belong to any chat software or character platform.

One-click deployment using only your phone

The default timezone is China Asia/Shanghai. Cloudflare will automatically create the database; no computer, terminal, database ID, or code changes are needed.

Related MCP server: apple-health-shortcuts-mcp

What is it like?

Apple Watch
    ↓ 自动同步
iPhone 的“健康”
    ↓ 快捷指令抄一份
你自己的 Cloudflare 小仓库
    ↓ 只有拿着 AI 钥匙才能看
支持 HTTP MCP 的 AI

AI will only see three tools:

• health_now: recent status, today's activity, and last night's sleep.

• health_detail: details of a specific night's sleep or a specific metric.

• health_trends: changes over the last 7, 14, or 30 days.

There are no tools like "modify health data", "delete data", or "remotely command the watch".

Where to start?

Please read first:

• Mobile-only "From-Scratch Tutorial"

• Word tutorial suitable for sharing and printing

When you need to troubleshoot from the command line, also see the advanced computer tutorial.

What's in the project

• src/index.ts: standalone Worker and MCP code.

• GUIDE-MOBILE.zh-CN.md: the default recommended mobile tutorial.

• schema.sql: a small drawer for health data.

• migrations/: automatically creates data tables during one-click deployment.

• wrangler.toml: Cloudflare project settings.

• scripts/make-keys.mjs: generates two private keys.

• examples/: fictional examples with no real personal information.

• SECURITY.md: privacy protection notes.

Developer self-check

npm install
npm test
npm run check

License and disclaimer

The code is under the MIT License; you may study, modify, and share it, but please keep the license.

This project only organizes data that users have explicitly authorized to upload; it does not provide medical diagnosis and is not suitable for emergencies. Apple, Apple Health, Apple Watch, and iPhone are trademarks of their respective owners; this project has no affiliation with or endorsement from Apple.