HealthZapBack to home

MCP — use HealthZap from AI

Connect HealthZap to Claude, ChatGPT, Cursor, OpenClaw, Hermes, Codex, or any MCP-compatible agent. Log water, weight, food, supplements, and measurements in plain language.

Same model as tools like Post Bridge: create an account on the website → get an API key → paste it into your agent config. Optional OAuth for clients that support one-click sign-in.

Setup in 3 steps

  1. Create an account and subscribe at tryhealthzap.com. Finish onboarding goals if you have not already.
  2. Open Settings → MCP & API keys, click Create key, and copy the hz_live_… secret (shown once).
  3. Add the MCP server to your AI client with the URL and Bearer header below. Restart the client, then ask it to log something.

MCP server URL

https://tryhealthzap.com/mcp

Auth header: Authorization: Bearer hz_live_your_key_here

Claude Code / HTTP MCP clients

Add to ~/.claude/settings.json (or your client’s MCP settings):

{
  "mcpServers": {
    "healthzap": {
      "type": "http",
      "url": "https://tryhealthzap.com/mcp",
      "headers": {
        "Authorization": "Bearer hz_live_your_api_key_here"
      }
    }
  }
}

Claude Desktop (via mcp-remote)

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "healthzap": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://tryhealthzap.com/mcp",
        "--header",
        "Authorization: Bearer hz_live_your_api_key_here"
      ]
    }
  }
}

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Cursor

Project or global MCP config (e.g. .cursor/mcp.json):

{
  "mcpServers": {
    "healthzap": {
      "url": "https://tryhealthzap.com/mcp",
      "headers": {
        "Authorization": "Bearer hz_live_your_api_key_here"
      }
    }
  }
}

Exact field names can vary by Cursor version — use a remote/HTTP MCP server with a custom Authorization header.

Claude / ChatGPT (OAuth, optional)

Clients that support remote MCP with OAuth can connect with only the server URL and complete browser sign-in + consent. Leave client ID/secret blank if your client registers automatically.

https://tryhealthzap.com/mcp

OAuth apps appear under Settings → OAuth connected apps; revoke anytime.

What your agent can do

  • Log water, weight, meals, supplements, body measurements
  • Set goals (water, calories, weight), height, timezone, units
  • Choose trackers and supplement/measurement stacks
  • Read today’s summary
  • Open Stripe billing portal (manage/cancel)

Requires an active subscription. Signup and payment happen on the website — not inside the agent.

Example prompts

  • “Log 500 ml of water on HealthZap.”
  • “Weigh in 72.4 kg.”
  • “I ate a banana (~100g).”
  • “Took creatine.”
  • “How am I doing on water and calories today?”
  • “Set my water goal to 3000 ml and enable the water tracker.”

Troubleshooting

  • 401 Unauthorized: check the key is hz_live_…, not revoked, and the header is Authorization: Bearer … (space after Bearer).
  • 403 / subscription: subscribe on the website, then retry.
  • Water setup required: set a water goal via the agent or dashboard first.
  • Revoke access: Settings → revoke the API key or OAuth app.

Questions? [email protected]