health4ai
io.github.jefflitt1/health4ai · 10 stars · Swift · MIT
MCP server Query your Apple Health data from your own Supabase/Postgres via local MCP.
Install
The repo has no one-line install. Follow its README.
Published as
- PyPI
health4aistdio
From the server's entry in the official MCP Registry.
Configuration
| Name | Set as | What it is |
|---|---|---|
DATABASE_URLRequired · Secret | Env var | Postgres connection string for your Supabase project (transaction pooler; database password, not a service-role key). |
HEALTHKIT_USER_IDRequired | Env var | UUID of the Supabase Auth user whose HealthKit data to query. |
Files
health4ai MCP server
Local MCP server that queries your Apple Health data from a Supabase/Postgres project you own. Use it with Claude Desktop, Claude Code, Cursor, or any stdio MCP client.
The data gets there from the free health4ai iOS app: download it on the App Store. Setup guide: https://health4.ai/setup/
Install
pip install health4ai
Requires Python 3.11+. From a clone of the repo you can still run the previous path:
pip install -r mcp-server/requirements.txt python mcp-server/main.py
Configure
The server talks to your database over stdio. Set these environment variables (or a .env file in the working directory):
| Variable | Required | Secret | Description |
|---|---|---|---|
DATABASE_URL |
yes | yes | Postgres connection string for your Supabase project (transaction pooler; database password, not the service_role key). SUPABASE_DB_URL is accepted as an alias. |
HEALTHKIT_USER_ID |
yes | no | UUID of the Supabase Auth user whose HealthKit rows to query. The server refuses to start if this is unset, not a UUID, or the 00000000-… placeholder. |
HEALTH4AI_TZ |
no | no | IANA time zone for calendar-day buckets (default UTC). |
Full walkthrough: docs/SETUP.md.
Run
After pip install health4ai:
health4ai # or python -m health4ai
Claude Desktop / Claude Code / Cursor (mcp.json):
{
"mcpServers": {
"health4ai": {
"command": "health4ai",
"env": {
"DATABASE_URL": "postgresql://...",
"HEALTHKIT_USER_ID": "<your auth user UID>"
}
}
}
}
From a git clone, "command": "python" and "args": ["/path/to/health4ai/mcp-server/main.py"] still work.
License
MIT. See the repository LICENSE.
Facts
- Kind
- MCP server
- Group
- Uncategorized
- Stars
- 10
- License
- MIT
- Language
- Swift
- Last push
- 2026-11-16
- Forks
- 6
- MCP Registry
- io.github.jefflitt1/health4ai
- Homepage
- health4.ai
- Topics
- apple-health, healthkit, mcp, supabase
Next on this shelf
- 6475io.github.joosthel/sevdesk-mcpio.github.joosthel/sevdesk-mcpComplete sevDesk MCP server: all API endpoints, guarded writes, built-in bookkeeping audits.10
- 6476OpenProfitio.github.lobbystack/openprofitRevenue, AI and hosting costs, and profit per product from Stripe, OpenAI, Vercel and more.10
- 6477Magic Hourio.github.magichourhq/magic-hourCreate and edit images and video, generate music, and retrieve existing audio projects.10
- 6478io.github.markswendsen-code/doordashio.github.markswendsen-code/doordashMCP server for DoorDash - let AI agents order food delivery autonomously with browser-based ordering10
- 6479openFlowio.github.molkex/omni-flash-veo3-nano-bananaOmni Flash and Veo video, Nano Banana images on Google Flow, from any MCP client10
- 6480Aseprite Liveio.github.oaktreegames/aseprite-live-mcpLive+headless Aseprite MCP: Unity export, art-QA, tilemaps, in-editor dialogs, update-aware10