claude-remote-mcp

Drive your Claude Code agents by voice from the Claude app (e.g. on CarPlay), through a custom MCP connector added to your Claude account.

Claude app (voice)
  └─ custom MCP connector ── HTTPS, Cloudflare Tunnel, bearer token
       └─ mcp-gateway   (gateway host, always on)   MCP server, auth, frugal tool output
            └─ LAN ──── agent-bridge   (agent host)   stateless HTTP API, project allowlist
                             └─ herdr CLI           owns agents and their state
                                  └─ Claude Code agents

Components

Each component has its own README with system requirements, configuration, deployment and tests.

You need:

• herdr 0.8.0+ and Claude Code on the agent host;

• uv on both hosts;

• an agent host that stays awake and logged in while you use it (see Keeping the agent host available);

• a Cloudflare account (the Free plan is fine) with a domain whose DNS is on Cloudflare;

• a Claude plan with custom connectors, and the Request headers option in the Add custom connector dialog. That option is a beta that only some accounts have; without it the connector can't send its token, and mcp-gateway has no OAuth sign-in instead.

The gateway and the agent host can be one machine.

Related MCP server: claude-voice-bridge

Setup order

1. Cloudflare: add your domain to Cloudflare if it isn't there yet (its DNS must be managed by Cloudflare), and pick a subdomain for the connector, e.g. mcp.example.com. Nothing else to create by hand: the setup script in step 3 makes the tunnel and the DNS record.

2. Agent host: start agent-bridge on its LAN address and note its token.

3. Gateway host: run mcp-gateway/deploy/setup.sh with that subdomain, agent-bridge's URL and token, and the projects folder. On the first run it prints a Cloudflare login URL: open it in any browser and pick your domain. It then sets up the service and the Cloudflare Tunnel and prints the connector token.

4. claude.ai: add the custom connector with that token.

Development

uv workspace; each component is its own package.

uv sync --all-packages
uv run --package agent-bridge pytest agent-bridge
uv run --package mcp-gateway pytest mcp-gateway

License

MIT