MCP Agent Mail
Rust MCP server for multi-agent coordination: 34 tools, Git-backed archive, SQLite indexing, advisory file locks, and an interactive TUI console
What is MCP Agent Mail?
MCP Agent Mail is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to rust mcp server for multi-agent coordination: 34 tools, git-backed archive, sqlite indexing, advisory file locks, and an interactive tui console
Rust MCP server for multi-agent coordination: 34 tools, Git-backed archive, SQLite indexing, advisory file locks, and an interactive TUI console
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Rust MCP server for multi-agent coordination: 34 tools, Git-
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-agent-mail-rustConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP Agent Mail
MCP Agent Mail (Rust) is a mail-like multi-agent coordination layer implemented as an MCP server with 37 tools and 25 resources, giving AI coding agents (Claude Code, Codex CLI, Gemini CLI, GitHub Copilot) persistent semi-ephemeral identities, threaded inbox/outbox messaging, advisory file reservations (glob-based leases with TTL and a pre-commit guard), SQLite-indexed search, and a Git-backed archive of every message and reservation. It also ships a 16-screen interactive TUI, a server-rendered web UI, and an agent-first robot CLI — the Rust rewrite of the original Python project (1,700+ stars) with stress-test-verified zero-error performance at 49 RPS sustained load.
Prerequisites
- Linux or macOS (x86_64 or aarch64); the install script auto-detects the platform
- curl available for the one-liner installer, or Rust toolchain if building from source
- Git installed (the archive backend stores all messages as Git commits)
- MCP-compatible AI coding agents: Claude Code, Codex CLI, Gemini CLI, or GitHub Copilot CLI
Install via the one-liner script (recommended)
The install script downloads the right binary for your platform, installs it to ~/.local/bin, updates your PATH, and auto-configures any detected Codex CLI installs for HTTP MCP.
curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/mcp_agent_mail_rust/main/install.sh?$(date +%s)" | bashStart the Agent Mail server
Run the 'am' command to start the server. It launches on 127.0.0.1:8765 with the interactive 16-screen TUI. The server stays running while your agents coordinate.
amInitialize a project and register agents
Agents use MCP tools to set up coordination. The ensure_project tool creates or opens a per-project Git archive, and register_agent assigns each agent a memorable identity like 'GreenCastle' or 'BlueLake'.
# These are called by agents via MCP tools, not directly:
# ensure_project(human_key="/abs/path/to/project")
# register_agent(project_key="/abs/path", program="claude-code", model="opus-4.6")Add Agent Mail to your MCP client configuration
Register the running Agent Mail server as an MCP server in your agent's configuration. It operates in HTTP MCP mode on port 8765.
Use the robot CLI for non-interactive agent workflows
The 'am robot' subcommand provides 18 agent-optimized CLI subcommands with toon/json/md output formats, useful for scripted or non-interactive multi-agent pipelines.
# Check agent status
am robot status --project /abs/path --agent BlueLake
# Read urgent inbox messages as JSON
am robot inbox --project /abs/path --agent BlueLake --urgent --format json
# Check for reservation conflicts
am robot reservations --project /abs/path --agent BlueLake --conflictsMCP Agent Mail Examples
Client configuration
MCP configuration pointing at the locally running Agent Mail HTTP server on port 8765.
{
"mcpServers": {
"mcp-agent-mail": {
"url": "http://127.0.0.1:8765/mcp"
}
}
}Prompts to try
Example agent instructions that use the 37 Agent Mail MCP tools for multi-agent coordination.
- "Register me as an agent called 'BlueLake' on this project and check my inbox."
- "Reserve src/auth/** exclusively for 1 hour so I can refactor the authentication module."
- "Send a message to 'GreenCastle' letting them know I've finished the API tests and released my reservation."
- "Search all messages in thread FEAT-123 for any mentions of breaking changes."
- "List all active file reservations and flag any that might conflict with the files I need to edit."Troubleshooting MCP Agent Mail
The 'am' command is not found after running the install script
The installer places the binary in ~/.local/bin. Run 'echo $PATH' to confirm ~/.local/bin is included. If not, add 'export PATH="$HOME/.local/bin:$PATH"' to your ~/.bashrc or ~/.zshrc and reload the shell with 'source ~/.bashrc'.
Agents report Git lock errors or SQLite timeout errors under heavy load
The Rust rewrite specifically addresses these Python-era failure modes. Ensure you are on the latest binary version (re-run the install script). The commit coalescer batches rapid-fire writes to reduce lock contention. If errors persist, check disk I/O — slow storage can cause SQLite busy timeouts even with WAL mode and 60s busy_timeout.
An agent's file reservation is blocking another agent but the original agent crashed
Reservations use TTL-based expiry — they automatically release after the TTL expires (default varies by reservation). Use 'am robot reservations --project /path --conflicts' to list stale reservations, then use the reclaim tool to release a reservation from a crashed agent. The pre-commit guard also respects stale lock recovery.
Frequently Asked Questions about MCP Agent Mail
What is MCP Agent Mail?
MCP Agent Mail is a Model Context Protocol (MCP) server that rust mcp server for multi-agent coordination: 34 tools, git-backed archive, sqlite indexing, advisory file locks, and an interactive tui console It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP Agent Mail?
Follow the installation instructions on the MCP Agent Mail GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP Agent Mail?
MCP Agent Mail works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP Agent Mail free to use?
Yes, MCP Agent Mail is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.
MCP Agent Mail Alternatives — Similar Coding Agents Servers
Looking for alternatives to MCP Agent Mail? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP Agent Mail in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP Agent Mail?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.