MCP Agent Mail provides a Python-based, Git-backed coordination layer for AI coding agents, offering identities, inbox/outbox, searchable threads, and advisory file leases via a FastMCP HTTP server. It emphasizes Git + SQLite for artifacts and includes a one-line installer and extensive start-up instructions.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
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. It is backed by Git for artifacts and SQLite for indexing and queries.
How it works
- Provides identities, inbox/outbox, and message threads.
- Supports advisory file reservations (leases) on files/globs to signal intent.
- Stores artifacts in Git and uses SQLite for indexing and queries.
- Exposes a server via FastMCP over HTTP and includes a CLI/typer-based toolset for interaction.
- Integrates with Beads for task planning via a Rust-based CLI (
br) with a compatibility alias (bd).
Getting started
One-line installer
curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/mcp_agent_mail/main/scripts/install.sh?$(date +%s)" | bash -s -- --yes
Starting the server after install
am
Port customization (example)
uv run python -m mcp_agent_mail.cli config set-port 9000
Manual setup paths (high-level)
Clone repo, set up Python 3.14 virtual environment, install uv, activate venv, install dependencies with uv sync, run installation scripts to detect agents, and start the MCP server on port 8765.
Recent releases
- v0.3.2 (2026-04-16): Full Changelog available; last release listed.
- v0.3.0 (2026-01-07): Stdio Transport, Tool Filtering, Push Notifications.
- v0.2.1 (2026-01-06): Highlights include Python 3.14 cancellation safety notes.
- v0.2.0 (2026-01-06): Comprehensive test coverage milestone.
- v0.1.5 (2026-01-04): Fixes for datetime comparison and placeholder detection.
Traction
2068 stars, 215 forks, 1 open issue.
Behind the repo
Dicklesworthstone is the repository owner; Beads integration details note Beads Rust (br) replaces Beads Go (bd) with a backwards-compatible aliasing setup.
Caveats
License is not listed. Created 2025-10-23; last push 2026-08-04. Language: Python. No license indicated in the facts.