Hevy MCP Server

An MCP server that gives AI agents (Claude, ChatGPT, n8n, etc.) access to your Hevy workout data.

Runs as a Docker container and exposes an SSE endpoint, making it easy to connect remotely via a Cloudflare tunnel or any reverse proxy.

Deploy with Docker

1. Clone the repo

git clone https://github.com/karlhsueh/hevyapp-mcp.git
cd hevyapp-mcp

2. Configure your credentials

cp .env.example .env

Edit .env and fill in:

HEVY_API_KEY=your-api-key-here   # from hevy.com/settings?developer (requires Hevy Pro)
MCP_AUTH_TOKEN=your-secret-token  # generate one: openssl rand -hex 32

MCP_AUTH_TOKEN protects the server — any client must send Authorization: Bearer <token> to connect. If unset, the server starts unprotected (fine for local-only use).

3. Start the container

docker compose up -d

Verify it's running:

curl http://localhost:3847/health
# {"status":"ok","server":"hevyapp-mcp"}

Related MCP server: Hevy MCP Server

Expose remotely via Cloudflare Tunnel

If you're self-hosting on a home server and want remote access:

1. Go to Cloudflare Zero Trust → Networks → Tunnels

2. Click your tunnel → Edit → Public Hostname → Add a public hostname

3. Fill in:

   • Subdomain: hevy-mcp (or anything you like)

   • Domain: your domain

   • Service: http://localhost:3847

4. Save — no tunnel restart needed

Your MCP server will be live at https://hevy-mcp.yourdomain.com/sse.

Connect to it

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "hevy": {
      "type": "sse",
      "url": "https://hevy-mcp.yourdomain.com/sse",
      "headers": {
        "Authorization": "Bearer your-secret-token"
      }
    }
  }
}

Restart Claude Desktop.

Claude Code (CLI)

claude mcp add hevy --transport sse https://hevy-mcp.yourdomain.com/sse \
  --header "Authorization: Bearer your-secret-token"

ChatGPT / other agents

URL: https://hevy-mcp.yourdomain.com/sse
Header: Authorization: Bearer your-secret-token

Local agents (same machine)

Same token required, but use localhost directly to skip Cloudflare:

http://localhost:3847/sse

Available tools

Updating

git pull
docker compose up -d --build

Logs

docker compose logs -f hevyapp-mcp