agent-mail

Coordinate multi-agent workflows with identities, inbox/outbox, and file reservations.

70|13|Updated Jan 5, 2026
One-click install
npx skills add https://github.com/Dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations --skill agent-mail-dicklesworthstone
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-mail
Source: https://github.com/Dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations/tree/main/skills/agent-mail
Command: npx skills add https://github.com/Dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations --skill agent-mail-dicklesworthstone

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

MCP Agent Mail provides a centralized mail-like coordination layer for multi-agent workflows, enabling identities, inbox/outbox, file reservations, threaded messaging, and governance utilities to keep parallel AI agents aligned.

Core Features & Use Cases

  • Memorable agent identities (adjective+noun) and project-scoped inbox/outbox for tracking conversations.
  • Advisory file reservations (leases) to signal editing intent and prevent conflicts.
  • Threaded messages with importance levels and optional acknowledgments for clear task communication.
  • Pre-commit guard to enforce reservations at commit time and reduce merge conflicts.
  • Human Overseer for direct human-to-agent communication and high-priority prompts.
  • Git and SQLite backends with export, disaster recovery, and human-auditable artifacts.

Quick Start

Start the server quickly using the alias or manual run: am Or manually: cd ~/projects/mcp_agent_mail ./scripts/run_server_with_token.sh

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 AI agents working on the same codebase to prevent file conflicts?

Multi-agent workflow coordination prevents file conflicts by using advisory file reservations on a Git and SQLite backend, signaling editing intent so parallel agents avoid modifying the same files simultaneously.

Can I use threaded messaging to track task progress across different projects with multiple agents?

Threaded messaging tracks task progress across projects by providing project-scoped inbox and outbox management, allowing agents to send messages with importance levels and optional acknowledgments for clear communication.

What's the best way to enforce file reservations before committing changes in a collaborative coding environment?

A pre-commit guard enforces file reservations at commit time in collaborative coding environments, reducing merge conflicts by verifying that agents hold valid leases on files before changes are committed to the Git repository.

Does FastMCP support human oversight for direct communication with AI agents?

FastMCP supports human oversight through a Human Overseer feature, enabling direct human-to-agent communication for high-priority prompts and governance within the multi-agent coordination workflow.

How do I start the MCP Agent Mail server for multi-agent coordination?

To start the MCP Agent Mail server for multi-agent coordination, run the alias command 'am' or manually execute the 'run_server_with_token.sh' script from the project directory to launch the FastMCP HTTP server.