Dicklesworthstone/mcp_agent_mail
Asynchronous coordination layer for AI coding agents: identities, inboxes, searchable threads, and advisory file leases over FastMCP + Git + SQLite
What it solves
MCP Agent Mail provides a coordination layer for multiple AI coding agents working on the same project. It prevents agents from overwriting each other's work or missing critical context by providing a shared communication fabric, identity management, and a system for signaling intent through file reservations.
How it works
The project operates as an HTTP-only FastMCP server that combines two persistence methods: Git for human-auditable markdown messages and SQLite for fast indexing, searching, and managing file leases. Agents can register unique identities, send and receive messages in threaded conversations, and declare "advisory file reservations" (leases) on specific files or globs to signal they are currently editing those areas.
Who it’s for
It is designed for developers using FastMCP clients and CLI tools (such as Claude Code, Codex, Gemini CLI, or Factory Droid) who are coordinating a fleet of heterogeneous agents across one or more codebases.
Highlights
- Asynchronous Coordination: Provides agents with inboxes, outboxes, and searchable message history to share context without consuming token budgets.
- File Reservations: Implements a lease system to prevent agents from stepping on each other's edits.
- Dual Persistence: Uses Git for audit trails and SQLite for high-performance queries.
- Agent Directory: Allows agents to inspect a directory of active identities, programs, and activity.
- Integration with Beads: Works alongside Beads (a task planner) to align task prioritization with communication and file locking.
Related
- Project
- Project
- Project
- Dispatch
- Dispatch