mcp_agent_mail

by Dicklesworthstone · Python · ★ 1,909

Asynchronous coordination layer for AI coding agents: identities, inboxes, searchable threads, and advisory file leases over FastMCP + Git + SQLite

#ai-agents#coordination#fastmcp#mcp#python

Install

pip install git+https://github.com/Dicklesworthstone/mcp_agent_mail.git

Claude Desktop config

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-agent-mail": {
      "command": "uvx",
      "args": [
        "git+https://github.com/Dicklesworthstone/mcp_agent_mail.git"
      ]
    }
  }
}

From the README

> "It's like gmail for your coding agents!" A mail-like coordination layer for coding agents, exposed as an HTTP-only FastMCP server. It gives agents memorable identities, an inbox/outbox, searchable message history, and voluntary file reservation "leases" to avoid stepping on each other. Think of it as asynchronous email + directory + change-intent signaling for your agents, backed by Git (for human-auditable artifacts) and SQLite (for indexing and queries). Status: Under active development. The design is captured in detail in (start with the original prompt at the top of that file). Mod…

Read full README on GitHub →