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.

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.

Metadata

Release files for health4ai 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for health4ai 0.1.0
File	Size	Uploaded	Provenance	Actions
health4ai-0.1.0.tar.gz	35.0 kB	Sep 19, 2026	Without provenance	Details for health4ai-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for health4ai 0.1.0
File	Interpreter	ABI	Platform	Actions Reset
health4ai-0.1.0-py3-none-any.whl 24.7 kB Sep 19, 2026 Without provenance	Python 3	none	any	Details for health4ai-0.1.0-py3-none-any.whl

Total release size: 59.8 kB

Release files / health4ai-0.1.0.tar.gz

Download URL	health4ai-0.1.0.tar.gz
Size	35.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`9d3fdf7d06067d50ffcf5e691ae8ee6e4c16d7100789be2101534c35ccb312af`
BLAKE2b-256 checksum How to use checksums	`a091180fc19518bb37b0648fae431e7765301ee7524d1715101d58846521a135`
Upload date	Sep 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.4`

Release files / health4ai-0.1.0-py3-none-any.whl

Download URL	health4ai-0.1.0-py3-none-any.whl
Size	24.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`faa7346e52e4676846bc10915a338e3d66dcfa358610711f7e6aa2523a9687a6`
BLAKE2b-256 checksum How to use checksums	`d1a490ad8f442cf9ff12c1d1f6fceb0e417696a549d7fe56460555a21c40efb1`
Upload date	Sep 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.4`

Security for health4ai 0.1.0

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

Sep 19, 2026 2 release files No provenance

health4ai 0.1.0