Setup in ~15 minutes

Checklist

1. 1
   Create a Supabase project

   Free tier at supabase.com. health4.ai needs Supabase Auth + Edge Functions — plain Postgres alone is not enough.

2. 2
   Run schema.sql

   Paste and run health4.ai/schema.sql in the SQL editor. Do not use supabase db push on a fresh project.

3. 3
   Deploy the edge function

   git clone https://github.com/jefflitt1/health4ai.git
   cd health4ai
   supabase functions deploy healthkit-ingest --project-ref <ref> --no-verify-jwt

   Also create your Auth user (Authentication → Users) and copy the UID.

4. 4
   Install the iOS app (invite-only)

   TestFlight is invite-only — there is no public link. Join thewaitlist and tick the consent box to request a beta invite. Once installed: enter Project URL + anon key, sign in, start sync. See TESTFLIGHT-BETA.md.

5. 5
   Clone mcp-server & install deps

   cd health4ai/mcp-server
   pip install -r requirements.txt
   cp .env.example .env

6. 6
   Set .env

   DATABASE_URL=postgresql://...   # transaction pooler, database password
   HEALTHKIT_USER_ID=<your auth UID>

7. 7
   Add Claude / Cursor MCP JSON

   {
     "mcpServers": {
       "health4ai": {
         "command": "python",
         "args": ["/path/to/health4ai/mcp-server/main.py"],
         "env": {
           "DATABASE_URL": "postgresql://...",
           "HEALTHKIT_USER_ID": "<your auth UID>"
         }
       }
     }
   }

   Claude Desktop / Claude Code config, or ~/.cursor/mcp.json. An npx one-liner is not published yet — clone + Python is the supported path.

8. 8
   Verify tools list

   In Claude Code run /mcp and confirm health4ai is connected with 11 tools. Then ask: "Give me a health summary for the last 7 days."Tool reference: /mcp-tools.