hoptell — Claude Code MCP server: messaging between AI agents
hoptell connects AI agents through a self-hosted relay: passes tasks, code and replies across Claude Code, Codex and other sessions on different machines and accounts.
Apache-2.0 ★ 10 updated 2026-10-08
claude mcp add --env HOPTELL_RELAY=<HOPTELL_RELAY> --env HOPTELL_TOKEN=<HOPTELL_TOKEN> --env HOPTELL_NAME=<HOPTELL_NAME> --env HOPTELL_ROLES=<HOPTELL_ROLES> --transport stdio hoptell -- npx -y hoptellWhat hoptell does
hoptell links agents through a WebSocket relay running on one machine in your LAN or VPN. Each agent gets tools — list_peers, send_message, read_inbox — and can route messages by name, role (@reviewer, @backend) or to everyone (@all). An incoming message wakes the receiving session: Claude Code uses channels or hooks, tmux supports fixed terminal notices, other sessions rely on polling.
Inside: one Node process with two dependencies (ws and the MCP SDK). Agents exchange text only through your relay, each still talks to its own AI provider. Queued messages for offline agents stay in the relay's memory until they return.
Without tmux 3.2 or later, waking terminal agents fails. The relay and polling tools work on Windows; everything else needs macOS or Linux.
What it helps with
- pass code for review from one machine to another without manual copying
- wake a remote agent with an incoming message
- ask the agent with the
@pmrole about the project's release plan - link several agents into a team where each handles its own part
- run a relay for agent communication without external services
Example prompts for the agent
- Send the contents of
auth.jsto agent Alex for a security check - Ask
@backendwhich endpoint the payments module uses - Show the list of connected agents and their roles
How to install hoptell
Platform CLI
claude mcp add --env HOPTELL_RELAY=<HOPTELL_RELAY> --env HOPTELL_TOKEN=<HOPTELL_TOKEN> --env HOPTELL_NAME=<HOPTELL_NAME> --env HOPTELL_ROLES=<HOPTELL_ROLES> --transport stdio hoptell -- npx -y hoptellReplace <…> with your own values
Platform CLI
codex mcp add hoptell --env HOPTELL_RELAY=<HOPTELL_RELAY> --env HOPTELL_TOKEN=<HOPTELL_TOKEN> --env HOPTELL_NAME=<HOPTELL_NAME> --env HOPTELL_ROLES=<HOPTELL_ROLES> -- npx -y hoptellReplace <…> with your own values
Config file
{
"mcpServers": {
"hoptell": {
"command": "npx",
"args": [
"-y",
"hoptell"
],
"env": {
"HOPTELL_RELAY": "<HOPTELL_RELAY>",
"HOPTELL_TOKEN": "<HOPTELL_TOKEN>",
"HOPTELL_NAME": "<HOPTELL_NAME>",
"HOPTELL_ROLES": "<HOPTELL_ROLES>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"hoptell": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hoptell"
],
"env": {
"HOPTELL_RELAY": "<HOPTELL_RELAY>",
"HOPTELL_TOKEN": "<HOPTELL_TOKEN>",
"HOPTELL_NAME": "<HOPTELL_NAME>",
"HOPTELL_ROLES": "<HOPTELL_ROLES>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e HOPTELL_RELAY=<HOPTELL_RELAY> -e HOPTELL_TOKEN=<HOPTELL_TOKEN> -e HOPTELL_NAME=<HOPTELL_NAME> -e HOPTELL_ROLES=<HOPTELL_ROLES> hoptell npx -y hoptellReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about hoptell
How do I install hoptell in Claude Code?
Run claude mcp add hoptell -e HOPTELL_RELAY=<HOPTELL_RELAY> -e HOPTELL_TOKEN=<HOPTELL_TOKEN> -- npx -y hoptell, filling in the relay address and token. Or install the plugin: /plugin marketplace add EminUZUN/hoptell, then /plugin install hoptell@hoptell.
What does hoptell do?
Routes messages between AI agents through your relay. One agent on one machine sends a task or code to another agent, which gets a notice and can reply. Works across different sessions, accounts and tools.
What does hoptell need to run?
Node.js 20 or later. To wake terminal agents, tmux 3.2 or later. The relay starts on one machine, agents connect to it using HOPTELL_RELAY and HOPTELL_TOKEN variables.