Apple Health in Codex

What you need

• An iPhone on iOS 15 or later with Apple Health. Apple Watch data comes along too.
• The HealthAPI app. Free for 2 days, no card needed. Then an optional 7-day free trial when you subscribe. The preview includes 25 requests a day. When the 2 days are up, AI apps and the API stop reading your data until you choose a plan in the app. Your synced data is kept for about 5 weeks, so subscribing picks up where you left off. Pro is $4.99 a month or $49.99 a year (100 requests a day); Developer is $9.99 a month or $99.99 a year (1,000 a day). Cancel anytime in the App Store.
• Codex: the CLI or the IDE extension.

Set it up in 4 steps

1. 1

   Install HealthAPI and sync

   Get HealthAPI from the App Store, open it and allow Apple Health. Your history uploads, then new data keeps syncing.
2. 2

   Add the server

   In a terminal, run codex mcp add healthapi --url https://healthapi.app/mcp. Codex saves it to ~/.codex/config.toml, sees that HealthAPI uses OAuth, and starts the sign-in straight away.
3. 3

   Approve on your iPhone

   A HealthAPI page opens in your browser with a short code. Scan its QR code with your iPhone, or enter the code in HealthAPI under Connect, check it matches, and tap Approve. Codex prints “Successfully logged in.”
4. 4

   Ask Codex

   Start codex, check /mcp lists healthapi, then ask for something that needs your data, such as “Use HealthAPI to get my last 30 nights of sleep.”

codex mcp add healthapi --url https://healthapi.app/mcp

The sign-in page labels Codex an unverified app and notes that it returns to a program on this computer (127.0.0.1). That is expected: HealthAPI can't check which program on your computer receives the answer. If you started it yourself and the codes match, approve it. Disconnect it later in the HealthAPI app under Settings, Connected apps.

In the IDE extension

Open the gear menu in the Codex panel, choose MCP servers, then Add server. Name it healthapi, choose Streamable HTTP, paste https://healthapi.app/mcp, save, and select Restart extension. The server list then shows HealthAPI as needing sign-in: select Authenticate and approve on your iPhone as above. A server added in the CLI shows up here too.

The config.toml entry

codex mcp add writes the first two lines to ~/.codex/config.toml. The third is optional: with "writes", Codex only asks before tools that aren't marked read only, and HealthAPI's are all read only, so it stops asking for them.

[mcp_servers.healthapi]
url = "https://healthapi.app/mcp"
default_tools_approval_mode = "writes"

Each call still uses one of your daily requests, so leave the approval line out if you'd rather see every call. To use your API key instead of signing in, copy it in the app (Connect, then Other tools), put it in an environment variable, and name the variable. The key stays out of the file:

[mcp_servers.healthapi]
url = "https://healthapi.app/mcp"
bearer_token_env_var = "HEALTHAPI_KEY"

What to build with it

• A weekly report. “Use HealthAPI to get my last four weekly summaries and write a Markdown report comparing them, with the numbers in a table.”
• A chart from real data. “Get 6 months of resting heart rate and HRV, save them as CSV, and write a small script that plots both.”
• Tests with real fixtures. “Call get_daily_summary once and save the response as a test fixture for the parser you're writing.”
• A question mid-task. “How much did I sleep this week compared with last?” works too.

What Codex builds should call the REST API with your key, not the MCP server; the JavaScript and Python guides show how. The MCP server page lists all eight tools and their inputs.

Questions