Claude Mesh
Networked Claude-to-Claude messaging over HTTP + MCP channels — DM, broadcast, thread, and permission-relay between Claude Code instances via a self-hosted relay + MCP channel bridge.
What is Claude Mesh?
Claude Mesh is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to networked claude-to-claude messaging over http + mcp channels — dm, broadcast, thread, and permission-relay between claude code instances via a self-hosted relay + mcp channel bridge.
Networked Claude-to-Claude messaging over HTTP + MCP channels — DM, broadcast, thread, and permission-relay between Claude Code instances via a self-hosted relay + MCP channel bridge.
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Networked Claude-to-Claude messaging over HTTP + MCP channel
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx claude-meshConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Claude Mesh
Claude Mesh is a self-hosted relay and MCP channel bridge that enables Claude Code instances to communicate with each other over HTTP. Each Claude instance connects to a shared relay server and gets three MCP tools — send_to_peer for direct messages or @team broadcasts, list_peers to see who is connected, and set_summary to share your current work status. This makes it possible to coordinate multi-agent workflows where one Claude instance delegates subtasks to another, checks in on progress, or asks for approval, all without leaving the terminal.
Prerequisites
- Node.js 18 or later and pnpm installed
- Git to clone the repository
- Docker (optional, for running the relay as a container)
- Claude Code CLI installed and authenticated
- Network access between all machines that will participate in the mesh (or run relay locally for single-machine setups)
Clone and build the monorepo
Clone the repository and build all packages including the relay server and the MCP peer agent package.
git clone https://github.com/pouriamrt/claude-mesh.git
cd claude-mesh
pnpm install && pnpm -r buildCopy and edit the environment file
The relay server needs a data directory and port. Copy the example env file and adjust PORT and MESH_DATA as needed.
cp .env.example .env
# Edit .env:
# PORT=8443
# HOST=127.0.0.1
# MESH_DATA=/path/to/persistent/storageInitialise the relay and create the first user
The init command sets up the database and prints an admin token. Save the token — you will need it to add team members.
node packages/relay/dist/index.js initStart the relay server
Start the relay so Claude instances can connect. For production use, run it in Docker instead.
# Local:
node packages/relay/dist/index.js
# Docker:
docker volume create mesh-data
docker run -d --name mesh-relay --restart unless-stopped \
-p 8443:8443 -v mesh-data:/data \
ghcr.io/pouriamrt/claude-mesh/relay:latestRegister the MCP server with Claude Code
On each machine participating in the mesh, register the MCP server so Claude Code loads the peer-agent tools on startup. Set MESH_RELAY to the URL of your relay.
MESH_RELAY=http://127.0.0.1:8443 claude --dangerously-load-development-channels mcp add claude-mesh-peersAdd team members via the admin CLI
Use the mesh CLI to create handles for each Claude Code instance that will participate. Each handle maps to a unique Claude agent in the mesh.
mesh admin add-user --handle alice --display-name "Alice"
mesh admin add-user --handle bob --display-name "Bob"Claude Mesh Examples
Client configuration
MCP config block for Claude Code or Claude Desktop connecting to a locally running Claude Mesh relay.
{
"mcpServers": {
"claude-mesh-peers": {
"command": "node",
"args": ["packages/peer-agent/dist/index.js"],
"cwd": "/absolute/path/to/claude-mesh",
"env": {
"MESH_RELAY": "http://127.0.0.1:8443",
"MESH_HANDLE": "alice"
}
}
}
}Prompts to try
Example commands for coordinating multi-agent Claude workflows through the mesh.
- "Who is currently connected to the mesh and what are they working on?"
- "Tell bob I'm done with the auth module and he can start the API layer"
- "Broadcast to @team that the database migration is complete"
- "Set my status to: working on rate limiting middleware"
- "Ask alice to review my changes and approve the permission request"Troubleshooting Claude Mesh
send_to_peer fails with 'peer not found' even though the handle exists
The target Claude instance must be actively connected to the relay for messages to be delivered. Check that the receiving Claude Code session has the MCP server loaded and that MESH_RELAY points to the same relay URL on both ends.
The relay server exits immediately after init with no error
Check that the MESH_DATA directory exists and is writable. If using Docker, ensure the mesh-data volume was created before running the container and that the volume path inside the container matches /data.
Claude Code does not show the send_to_peer and list_peers tools
The --dangerously-load-development-channels flag is required when registering the MCP server because claude-mesh uses a non-standard channel. Re-run the mcp add command with that flag and restart Claude Code.
Frequently Asked Questions about Claude Mesh
What is Claude Mesh?
Claude Mesh is a Model Context Protocol (MCP) server that networked claude-to-claude messaging over http + mcp channels — dm, broadcast, thread, and permission-relay between claude code instances via a self-hosted relay + mcp channel bridge. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Claude Mesh?
Follow the installation instructions on the Claude Mesh GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Claude Mesh?
Claude Mesh works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Claude Mesh free to use?
Yes, Claude Mesh is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Claude Mesh Alternatives — Similar Communication Servers
Looking for alternatives to Claude Mesh? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Claude Mesh in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Claude Mesh?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.