home / mcp / mcp talk mcp server

MCP Talk MCP Server

Enables inter-agent messaging with per-project namespaces and file-based message persistence.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "devinvenable-mcp-talk": {
      "command": "mcp-talk",
      "args": [],
      "env": {
        "MCP_TALK_QUEUE": "~/.mcp_talk/q/",
        "MCP_TALK_AUTO_CLEAN_HOURS": "24",
        "MCP_TALK_MAX_MESSAGE_CHARS": "2000"
      }
    }
  }
}

Model Context Protocol (MCP) Talk provides a lightweight, cross-agent messaging system that lets AI agents communicate in real-time through a shared, file-based queue. It enables simple interactions like sending direct messages, broadcasting to all agents, acknowledging messages, and replying with automated routing, all while keeping messages organized by project namespaces.

How to use

You run a small MCP message server that other agents connect to through standard MCP client configurations. From your MCP client, you can send direct messages, check for new messages, acknowledge deliveries, broadcast to all agents, and reply to responses. Use namespaces to keep messages isolated per project. For example, in a game project you can send a task to a teammate with a dedicated namespace, and in a work project you can route PR reviews separately.

How to install

Prerequisites you need before installing: Python 3.10 or later.

Install the MCP Talk server runtime using the recommended package manager.

# 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 .

Additional setup and configuration

Configure each MCP client to connect to the MCP Talk server. The following are valid runtime configurations you can place in your client’s project settings.

json
{
  "mcpServers": {
    "mcp-talk": {
      "command": "mcp-talk"
    }
  }
}

Available tools

send

Send a direct message to a specific agent. You specify the recipient, the message content, and optionally the sender.

check

Check for new messages for an agent. You can limit the results and choose to include full bodies or auto-acknowledge messages.

ack

Acknowledge and remove a message by its unique identifier.

broadcast

Send a message to all connected agents within the same MCP Talk namespace.

list

List all messages in the queue for a lightweight inbox view.

clean

Remove old messages based on a time window to prevent unbounded growth.

reply

Reply to a specific message and automatically forward the reply to the original sender while acknowledging the original message.