Apple Health Shortcuts MCP

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

This is an independent, open-source project written from scratch. It does not rely on paid health export apps, nor does it belong to any chat software or role-playing platform.

One-click deploy with just your phone

The default timezone is Asia/Shanghai. Cloudflare will automatically create the database. No computer, terminal, database ID, or code modification needed.

Related MCP server: apple-health-shortcuts-mcp

What does it look like?

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

The AI will only see three tools:

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

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

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

There are no tools like "Modify health data", "Delete data", or "Remote command watch".

Where to start?

Please read these first:

• "From Zero Setup Tutorial" using only your phone

• Word tutorial suitable for sharing and printing

For command-line troubleshooting, refer to the Advanced Computer Tutorial.

What's in the project?

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

• GUIDE-MOBILE.zh-CN.md: Default recommended phone tutorial.

• schema.sql: 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 without real personal data.

• SECURITY.md: Privacy protection notes.

Developer self-check

npm install
npm test
npm run check

License and Disclaimer

The code uses the MIT License. It can be studied, modified, and shared, but the license must be retained.

This project only organizes data voluntarily uploaded by users. 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.