Connect to Server

The TCP/MCP Server allows you to query your health data directly from other devices over your local network. This enables integration with other applications, scripts, or services running on the same network.

Overview

The TCP/MCP Server creates a local network server that accepts connections from other devices and applications. You can query health data, run automations, and interact with Health Auto Export programmatically.

Use Cases:

• Query health data from other devices on your network
• Integrate with local applications and scripts
• Access health data from command-line tools
• Build custom integrations using the MCP protocol

Key Features:

• TCP-based server for reliable connections
• MCP (Model Context Protocol) support
• Local network access
• Real-time health data queries
• Programmatic automation control

Limitations:

• App must be running in the foreground
• Currently unencrypted (use on trusted networks only)
• Requires Local Network permission
• Connections only work while server is running

Prerequisites

• Health Auto Export running on your iPhone/iPad
• Devices on the same local network
• Local Network permission granted
• Premium subscription
• Trusted network

Starting the Server

1. On the Server screen, tap Start Server"
2. Wait for the server to start (status will change to "Running")
3. Note the IP address and port displayed on screen
4. The server is now accepting connections

IP Address/Port Display:

• The server displays your device's IP address
• The default port is 9000

Connecting to the Server

Finding Your IP Address

The server screen displays your device's IP address automatically. This is the address other devices should use to connect.

Example: 192.168.1.100:9000

Using the Server

MCP Protocol

The server uses the Model Context Protocol (MCP) for communication.

Connection Logs

The Server screen displays connection logs showing:

• Incoming connection attempts
• Request details
• Response information
• Error messages

Viewing Logs:

• Logs appear automatically in the list on the Server screen
• Scroll to see recent activity
• Logs help debug connection issues