health-auto-export

Health Auto Export MCP server exposes a TCP-based interface for querying data from the Health Auto Export app and enables integration with large language models (LLMs) via MCP, such as Claude Desktop. The project includes a TCP client example and a server entry point that you can point to from MCP configurations to enable local querying and orchestration. To use the MCP server, first build the project to generate the server bundle, then start the node server that serves the MCP endpoint. You can connect to this MCP server from Claude Desktop or other MCP-compatible clients by referencing the server configuration provided in the repository (e.g., health_auto_export) and ensuring your HAE_HOST value is correctly set so the server can reach your Health Auto Export device.

• Prerequisites

  • Node.js v18 or higher
  • npm (comes with Node.js)
  • Health Auto Export app installed on iPhone/iPad with Premium access
  • Devices on the same Wi-Fi network

• Step-by-step installation

  1. Clone the repository:

     git clone <repository-url>
     cd health-auto-export-mcp-server
     

  2. Install dependencies:

     npm install
     

  3. Configure environment:
     • Copy the .env.example file to .env
     • Set HAE_HOST to the IP address of your Health Auto Export device on the local network

     cp .env.example .env
     # edit .env and set HAE_HOST
     

  4. Build the project:

     npm run build
     

  5. Run the development server:

     npm run dev
     

• Usage reminders

  • The TCP server is exposed via the Node.js entry at dist/server.js after building.
  • For Claude MCP integration, follow the configuration steps in server.ts and the example JSON provided in the repository's docs.

• Environment variables: HAE_HOST should point to your Health Auto Export device on the network. Ensure firewall rules allow TCP on the server port used by the MCP server.
• When using Claude Desktop, ensure you place the proper path to the built server (dist/server.js) in the Claude MCP config as illustrated in the README.
• If you encounter connection issues, verify that both devices (your computer running the MCP server and the iPhone/iPad with Health Auto Export) can ping each other on the network.
• Build steps are required before running the dev server to generate dist/server.js referenced by the MCP configuration.
• Refer to docs/tcp-server.md for additional TCP usage examples and client-side integration tips.