MCP Agent Mail

Active
GitHub Python NOASSERTION

Description

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

Key Features

  • MCP HTTP server providing agents with identities, inboxes, outboxes, and searchable message history
  • Advisory file reservation leases to prevent agents from overwriting each other's edits
  • Git-backed audit trail for all messages, leases, and attachments with full traceability
  • One-line installer that auto-detects and wires up Claude Code, Codex, Gemini CLI, and other coding agents
  • Built-in Beads Rust task tracker with interactive TUI for managing agent backlogs
  • Companion iOS app for provisioning, pairing, and steering agent fleets from mobile

Use Cases

πŸ’‘ Coordinate multiple coding agents (frontend, backend, infra) across a shared codebase
πŸ’‘ Prevent file conflicts between parallel agent workstreams with advisory leases
πŸ’‘ Maintain searchable audit logs of all agent communications for compliance and debugging
πŸ’‘ Manage agent task backlogs with the integrated Beads task tracker
πŸ’‘ Remotely provision and steer heterogeneous agent fleets via the companion app

Tags

mcp multi-agent coordination agent-communication coding-agent

Categories

πŸ”Œ MCP Tools 🧠 Multi-Agent

Quick Start

Run `curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/mcp_agent_mail/main/scripts/install.sh" | bash -s -- --yes` to install everything automatically. After installation, type `am` in any terminal to start the server. The installer auto-detects and configures your installed coding agents.
Visit GitHub

Related Projects