claude-peers-mcp

Skill by ara.so — Daily 2026 Skills collection.

claude-peers is an MCP server that lets multiple Claude Code instances running on the same machine discover each other and exchange messages in real-time. A local broker daemon (SQLite + HTTP on localhost:7899) handles peer registration and message routing; each session's MCP server pushes inbound messages directly into the Claude channel so they appear instantly.

Installation

1. Clone and install dependencies

git clone https://github.com/louislva/claude-peers-mcp.git ~/claude-peers-mcp
cd ~/claude-peers-mcp
bun install

2. Register as a global MCP server

claude mcp add --scope user --transport stdio claude-peers -- bun ~/claude-peers-mcp/server.ts

Adjust the path if you cloned elsewhere.

3. Launch Claude Code with the channel enabled

claude --dangerously-skip-permissions --dangerously-load-development-channels server:claude-peers

Add a shell alias to avoid typing it every time:

# ~/.bashrc or ~/.zshrc
alias claudepeers='claude --dangerously-load-development-channels server:claude-peers'

The broker daemon starts automatically on first use. No manual daemon management needed.

Requirements

• Bun runtime
• Claude Code v2.1.80+
• claude.ai login (channels require it — API key auth does not work)

Architecture

                    ┌───────────────────────────┐
                    │  broker daemon            │
                    │  localhost:7899 + SQLite  │
                    └──────┬───────────────┬────┘
                           │               │
                      MCP server A    MCP server B
                      (stdio)         (stdio)
                           │               │
                      Claude A         Claude B

• Each Claude Code session spawns its own server.ts MCP process over stdio
• MCP servers register with the broker and poll every second
• Inbound messages are pushed via the claude/channel protocol for instant delivery
• The broker auto-cleans dead peers and is localhost-only

MCP Tools Reference

Example prompts to Claude

List all peers on this machine

Send a message to peer abc123: "what files are you editing right now?"

Set your summary to: "refactoring the authentication module"

Check for any new messages from peers

CLI Usage

Inspect and interact with the broker directly from the terminal:

cd ~/claude-peers-mcp

# Show broker status and all registered peers
bun cli.ts status