Skip to main content
Glama

claude-remote-mcp

CI CodeQL License: MIT Python 3.11+

Voice-driven remote orchestration for Claude Code agents. Manage and supervise AI coding agents from anywhere using natural language.

Components

How the layers fit together, where state lives and the trust boundaries: ARCHITECTURE.md. Each component has its own README with system requirements, configuration, deployment and tests.

Directory

Runs on

Role

mcp-gateway/

an always-on host: a small home server, a VPS, or the agent host itself (Linux, macOS; the setup script needs Debian-based Linux with systemd)

MCP server exposed to claude.ai through a Cloudflare Tunnel; signs the connector in with OAuth (a passphrase) and forwards tool calls to agent-bridge. Includes a setup script.

agent-bridge/

the machine where herdr and Claude Code run (macOS, Linux or Windows)

Narrow LAN-only HTTP API translating requests into herdr CLI calls; keeps only its id and its gateway. Enrolls itself with the gateway. Runs as a launchd or systemd user service, or a Windows scheduled task.

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.

The gateway and the agent host can be one machine.

Related MCP server: qiao

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 2 makes the tunnel and the DNS record.

  2. Gateway host: run mcp-gateway/deploy/setup.sh with that subdomain. 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, prints the sign-in passphrase, and prints an enrollment string for the agent hosts, good for 30 minutes (sudo mcp-gateway enroll prints a new one).

  3. Agent hosts: on a Mac, run agent-bridge/deploy/macos/setup.sh and paste that string when asked; it installs the service and enrolls it. On Linux, agent-bridge/deploy/linux/setup.sh does the same with a systemd user service. On Windows, run powershell -ExecutionPolicy Bypass -File agent-bridge\deploy\windows\setup.ps1 and paste that string when asked; it installs a logon task, adds a firewall rule for the port (Private networks only) and enrolls it. Elsewhere, start agent-bridge, then enroll it with that string.

  4. claude.ai: add the custom connector by its URL and sign in with that passphrase.

If you have more than one Claude subscription, e.g. a work and a personal one, agents can start on the right one for each project folder: see Claude accounts.

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Self-hostable MCP server that gives Claude tools to run shell scripts and read files on a home server, deployed via Multipass VM and Cloudflare Tunnel.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      A self-hosted bridge that exposes local stdio MCP servers to ChatGPT and Claude over HTTPS with OAuth, providing a secure passthrough for your own tools.
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Lets MCP clients such as Claude Code, Cursor, and Claude.ai inspect and drive herdr workspaces, panes, and coding agents over a local socket, running either as a local stdio process or as an OAuth-protected HTTP endpoint published through a Cloudflare Tunnel. It exposes tools to create workspaces and tabs, split panes, start and prompt agents, read their output, and wait for results.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables cloud AI agents to access local STDIO MCP servers and their tools through a single authenticated Streamable HTTP endpoint, optionally tunneled via ngrok.
      39 npm
      1
      MIT