Description

A coordinated multi-agent messaging and coordination MCP server that enables AI agents to communicate through structured messages, claim exclusive access to file paths, and maintain persistent project archives with Git-based version control. Built with FastMCP, SQLModel, and PostgreSQL, it features full-text search capabilities, acknowledgment tracking, attachment processing with automatic image conversion to WebP, and pre-commit guards that prevent conflicting file modifications across agents. The system organizes agents into projects with human-readable names, stores all communications in both database and filesystem archives, and includes comprehensive CLI tooling for project management, claims inspection, and acknowledgment monitoring, making it useful for coordinating multiple AI agents working on shared codebases or collaborative tasks where conflict prevention and communication history are essential.

Installation

git clone https://github.com/dicklesworthstone/mcp_agent_mail

Claude Desktop Configuration

Add this configuration to your Claude Desktop config file to enable this MCP server:

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json

Config file location: %APPDATA%\Claude\claude_desktop_config.json

Config file location: ~/.config/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "agent-mail": {
      "command": "node",
      "args": [
        "path/to/server.js"
      ]
    }
  }
}