ClaudeCodeMod

All shelves / MCP servers

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

  • PyPIhealth4aistdio

From the server's entry in the official MCP Registry.

Open the repo

Configuration

NameSet asWhat it is
DATABASE_URLRequired · SecretEnv varPostgres connection string for your Supabase project (transaction pooler; database password, not a service-role key).
HEALTHKIT_USER_IDRequiredEnv varUUID of the Supabase Auth user whose HealthKit data to query.

Files

mcp-server/README.md

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
Repo
jefflitt1/health4ai
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

  1. 6475io.github.joosthel/sevdesk-mcpio.github.joosthel/sevdesk-mcpComplete sevDesk MCP server: all API endpoints, guarded writes, built-in bookkeeping audits.10
  2. 6476OpenProfitio.github.lobbystack/openprofitRevenue, AI and hosting costs, and profit per product from Stripe, OpenAI, Vercel and more.10
  3. 6477Magic Hourio.github.magichourhq/magic-hourCreate and edit images and video, generate music, and retrieve existing audio projects.10
  4. 6478io.github.markswendsen-code/doordashio.github.markswendsen-code/doordashMCP server for DoorDash - let AI agents order food delivery autonomously with browser-based ordering10
  5. 6479openFlowio.github.molkex/omni-flash-veo3-nano-bananaOmni Flash and Veo video, Nano Banana images on Google Flow, from any MCP client10
  6. 6480Aseprite Liveio.github.oaktreegames/aseprite-live-mcpLive+headless Aseprite MCP: Unity export, art-QA, tilemaps, in-editor dialogs, update-aware10