mcp-talk

# MCP Talk Inter-agent messaging via Model Context Protocol (MCP). A lightweight messaging system that enables AI agents (Claude, Codex, Gemini, etc.) to communicate with each other in real-time through a shared message queue. ## Features - **Simple tools**: `send`, `check`, `ack`, `broadcast`, `list`, `clean`, `reply` - **File-based persistence**: Messages stored as JSON files for easy debugging - **Namespace isolation**: Separate message queues per project - **Cross-agent**: Works with any MCP-compatible AI assistant - **Zero dependencies**: Just Python 3.10+ and the MCP SDK ## Installation ```bash # From PyPI (recommended) pipx install mcp-talk # Or with pip pip install mcp-talk # From source git clone https://github.com/devinvenable/mcp-talk.git cd mcp-talk pipx install . ``` ## Configuration Add to your MCP client configuration: ### Claude Desktop / Claude Code ```json { "mcpServers": { "mcp-talk": { "command": "mcp-talk" } } } ``` ### Using uvx (no install required) ```json { "mcpServers": { "mcp-talk": { "command": "uvx", "args": ["mcp-talk"] } } } ``` ### Codex CLI (~/.codex/config.toml) ```toml [mcp_servers.mcp-talk] command = "mcp-talk" ``` ### Gemini CLI (~/.gemini/settings.json) ```json { "mcpServers": { "mcp-talk": { "command": "mcp-talk" } } } ``` ## Tools ### `send` - Send a direct message ``` send(to="codex", message="Please review PR #123", from_agent="claude") ``` ### `check` / `chk` - Check messages ``` check(agent="claude") chk(agent="claude", include_body=true, auto_ack=true) ``` Returns up to 5 messages by default. Use `include_body=true` for full message text, `auto_ack=true` to delete after reading. ### `broadcast` - Send to all agents ``` broadcast(message="Standup in 5 minutes", from_agent="pm") ``` ### `ack` - Acknowledge/delete a message ``` ack(id="20251126_143022_abc12345") ``` ### `reply` - Reply to a message ``` reply(id="20251126_143022_abc12345", me…