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.