claude-envoy

claude-envoy

MCP server that dispatches Claude Code agents to any local or remote directory

Install

git clone https://github.com/michaelslain/claude-envoy.git
claude --plugin-dir /path/to/claude-envoy

Usage

The envoy tool dispatches a Claude Code agent into a directory with a prompt and returns its output.

Parameter	Type	Required	Description
directory	string	yes	Absolute path to run the agent in
prompt	string	yes	Task to give the spawned agent
host	string	no	SSH host for remote dispatch (e.g. user@host)
model	string	no	Model override: opus, sonnet, haiku
effort	string	no	Thinking effort: low, medium, high
timeout	number	no	Timeout in seconds (default: 300)

Examples

Local dispatch

envoy({
  directory: "/Users/me/my-project",
  prompt: "Run the tests and fix any failures"
})

Remote SSH dispatch

envoy({
  directory: "/home/user/api",
  host: "user@prod-server",
  prompt: "Check the logs for errors in the last hour"
})

Parallel dispatch

envoy({ directory: "/Users/me/frontend", prompt: "Add dark mode support" })
envoy({ directory: "/Users/me/backend",  prompt: "Add the /theme endpoint" })

Using different models

envoy({
  directory: "/Users/me/project",
  prompt: "Refactor the auth module",
  model: "opus",
  effort: "high"
})

Requirements

• Bun runtime
• Claude CLI installed and authenticated
• SSH access to the target host (for remote dispatch), with Claude CLI installed there

Development

git clone https://github.com/michaelslain/claude-envoy.git
cd claude-envoy
bun install

Test locally:

claude --plugin-dir .

Run the MCP server directly:

bun server.ts

Watch mode:

bun --watch server.ts

License

MIT