agent-mail

Coordinate coding agents with Git and SQLite-backed messaging and audit trails.

1|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/OmelchMichael/mcp_agent_mail --skill agent-mail-omelchmichael
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-mail
Source: https://github.com/OmelchMichael/mcp_agent_mail/tree/main
Command: npx skills add https://github.com/OmelchMichael/mcp_agent_mail --skill agent-mail-omelchmichael

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

MCP Agent Mail coordinates multiple coding agents by providing memorable identities, inbox/outbox, and an auditable Git+SQLite-backed history to prevent conflicts and streamline collaboration.

Core Features & Use Cases

  • Identity management with adjective+noun names bound to each agent's program and model.
  • Threaded messaging with searchable history stored in Git and indexed in SQLite.
  • Advisory file reservations (leases) to signal intent and avoid edit conflicts, plus a pre-commit guard and Human Overseer workflow for priority changes.
  • Disaster recovery and static exports to preserve audit trails and enable offline/archived review.

Quick Start

Start the MCP Agent Mail server using the provided startup script or the am alias, then open http://127.0.0.1:8765/mail to view inboxes.

Frequently Asked Questions about agent-mail

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I coordinate multiple coding agents to prevent edit conflicts in a shared repository?

Agent coordination systems prevent edit conflicts by providing memoizable identities, inbox/outbox messaging, and advisory file reservations (leases) that signal intent. They use a Git+SQLite-backed audit trail to manage threaded discussions and avoid duplicate work across agents.

How does Git and SQLite backing work for agent communication history?

Git and SQLite backing works by storing searchable communication history in Git commits while indexing it in SQLite. This provides a disaster recovery mechanism and enables static exports for offline or archived review of the audit trail.

Can I use MCP messaging for agents across multiple repositories?

Yes, MCP messaging applies across both single-repo and multi-repo setups, enabling per-agent inboxes and threaded discussions. It coordinates multiple coding agents by providing memoizable identities bound to each agent's program and model.

How do I set up an agent inbox system with a Human Overseer workflow?

Start the MCP server using a provided startup script or alias, then access the interface at a local port to view inboxes. The Human Overseer workflow integrates with advisory file reservations and a pre-commit guard for priority management.

What's the best way to manage file reservations when multiple agents edit the same codebase?

Advisory file reservations (leases) are the best way to manage concurrent edits, signaling intent to avoid conflicts. A pre-commit guard enforces these leases, while a Human Overseer workflow allows priority changes when reservation conflicts arise.

Do I need FastMCP HTTP transport to run agent mail coordination?

Yes, FastMCP HTTP transport and Python tooling are required dependencies for running agent coordination. The system relies on these components to provide the MCP server, memoizable identities, and the disciplined data-audit approach needed for operation.