LibreAI / Dev Tools / mcp_agent_mail
// devtools · Dicklesworthstone/mcp_agent_mail

mcp_agent_mail

Gmail for coding agents: identities, inboxes, threads, and file leases over FastMCP, Git, and SQLite.

★ 2.2k stars⑂ 229 forksNOASSERTIONupdated 2026-09
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

mcp_agent_mail is an open-source dev tools project by Dicklesworthstone (Dicklesworthstone/mcp_agent_mail on GitHub). It has 2,197 GitHub stars and 229 forks, is released under the NOASSERTION license, and was last updated on GitHub on 29 September 2026.

GitHub stars
2,197
Forks
229
License
NOASSERTION
Last updated on GitHub
29 September 2026
Category
Dev Tools
Listing
Full install guide
// how it works

How it works

  1. Clarify your goal

    Decide which parallel agents or workstreams need to coordinate, and on which repositories.

  2. Get the project

    Install with the one-line installer, which sets up the environment, integrates detected agent tools, and starts the server on port 8765.

  3. Install and configure

    Register an identity for each agent in the project, and reserve files before editing them to signal intent.

  4. Run your first task

    Have agents exchange threaded messages, check inboxes, and acknowledge work; restart later with the saved-token run script.

// features

Why people love it

Agent identities and directory

Agents register persistent, memorable identities and can inspect a directory of active agents, programs, and models.

Inbox, outbox, and searchable threads

Agents send GitHub-Flavored Markdown messages with images, and can search, summarise, and thread conversation history.

Advisory file reservations

Leases on files or globs signal editing intent and prevent parallel agents from stepping on each other's changes.

Git plus SQLite backing

Messages and artifacts are stored in Git for human auditability, while SQLite indexes them for fast queries.

Macros and fast resource reads

Bundled macros cover common flows like starting a session or reserving files, and resource URIs give quick inbox and thread reads.

Automatic agent-tool integration

The installer detects installed coding tools and configures them, and integrates with the Beads task planner for dependency-aware work selection.

Advertisement
// run it

Run it yourself

  1. Clone and set up manually (or use the one-line installer from the README)

    The manual path uses uv with a Python 3.14 virtual environment.

    git clone https://github.com/Dicklesworthstone/mcp_agent_mail.git
    cd mcp_agent_mail
    uv venv -p 3.14 && uv sync
  2. Integrate detected agents and start the server

    The bundled script wires up installed coding-agent tools and starts the MCP HTTP server on port 8765.

    scripts/automatically_detect_all_installed_coding_agents_and_install_mcp_agent_mail_in_all.sh
  3. Restart the server later

    Reuse the saved bearer token with the helper script, or just type the am alias the installer adds.

    scripts/run_server_with_token.sh
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains it?

It is maintained by Dicklesworthstone on GitHub; check the repository for the current license terms, as the catalog metadata lists NOASSERTION.

Is it free to use?

The server itself is open source and free to run locally; the agents that use it run on your own model accounts. A separate commercial companion app is mentioned in the README but is not required.

Does it need a paid API key?

Agent Mail needs no LLM API key of its own; it is coordination infrastructure for agents that already have their own model access.

How does it compare to a well-known alternative?

Chat-based coordination consumes context and disappears with the session; Agent Mail persists identities, threads, and file leases in Git and SQLite, searchable across sessions and agents.

How do I get started?

Run the one-line installer from the README, or clone the repo, uv sync, and run the auto-detect integration script to start the server on port 8765.

// keep exploring

Similar tools

Dev Tools

wigolo

Local-first web search, fetch, crawl and research for AI coding agents over MCP — no API keys.

★ 5.5k starsAGPL-3.0
View guide →
Dev Tools

agent-manager

A tmux TUI for managing AI coding agents — status, prompts, worktrees, diffs.

★ 564 starsApache-2.0
View guide →
Dev Tools

orca

The agent development environment for running a fleet of parallel coding agents in worktrees

★ 87.8k starsMIT
View guide →
Dev Tools

serena

An MCP toolkit that gives coding agents IDE-grade semantic retrieval, editing and refactoring

★ 30.1k starsGPL-3.0
View guide →
Dev Tools

agent-skills

Production-grade engineering skills for AI coding agents, by Addy Osmani — 25 skills in one pack

★ 103.3k starsMIT
View guide →
Dev Tools

ripwire

The ripgrep of AI context — a zero-dependency C++23 CLI + MCP server that maps your repo for coding agents

★ 2.4k starsApache-2.0
View guide →
// alternatives

Alternatives in Dev Tools

The most-starred other Dev Tools projects in the LibreAI catalogue — the realistic shortlist if mcp_agent_mail is not the right fit.

Get mcp_agent_mail

Free and open — grab the source, star the repo, and start creating.