mcp_agent_mail_rustに置き換えられました。 このPythonバージョンは現在メンテナンスされていません。新規インストールにはRust版を使用してください。

「コーディングエージェントのためのGmailみたいなものだよ!」

メールのようなコーディネーションレイヤーで、HTTP専用のFastMCPサーバーとして公開されています。エージェントに記憶に残るアイデンティティ、受信箱/送信ボックス、検索可能なメッセージ履歴、そして互いに干渉しないように任意のファイル予約「リース」を提供します。

エージェント向けの非同期メール+ディレクトリ+変更意図シグナリングのようなもので、Git(人間が監査可能なアーティファクト用)とSQLite(インデックス作成やクエリ用)を裏付けています。

ステータス:進行中。デザインの詳細はdocs/planning/project_idea_and_guide.mdに記録されています(そのファイルの上部にある元のプロンプトから始めてください)。

なぜこれが存在するのか

現代のプロジェクトでは、複数のコーディングエージェント(バックエンド、フロントエンド、スクリプト、インフラ)を同時に実行することが多いです。共有された調整ファブリックがなければ、エージェントは以下のようになります。

• お互いの編集を上書きしたり、予期しない差分にパニックになる
• 並列作業ストリームからの重要な文脈を見逃す
• ツールやチーム間でメッセージを「連絡」する作業を人間に求める

このプロジェクトは、エージェントが以下を行うための軽量で相互運用可能なレイヤーを提供します:

MCP Agent Mail

Superseded by mcp_agent_mail_rust. This Python version is no longer maintained; use the Rust version for new installs.

“It’s like gmail for your coding agents!”

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.

Think of it as asynchronous email + directory + change-intent signaling for your agents, backed by Git (for human-auditable artifacts) and SQLite (for indexing and queries).

Status: Maintenance mode. This Python implementation is superseded by the Rust rewrite and is no longer actively developed; new installs should use mcp_agent_mail_rust. The original design is captured in detail in docs/planning/project_idea_and_guide.md (start with the original prompt at the top of that file).

Why this exists

Modern projects often run multiple coding agents at once (backend, frontend, scripts, infra). Without a shared coordination fabric, agents:

• Overwrite each other’s edits or panic on unexpected diffs
• Miss critical context from parallel workstreams
• Require humans to “liaison” messages across tools and teams

This project provides a lightweight, interoperable layer so agents can:

• Register a temporary-but-persistent identity (e.g., GreenCastle)
• Send/receive GitHub-Flavored Markdown messages with images
• Search, summarize, and thread conversations
• Declare advisory file reservations (leases) on files/globs to signal intent
• Inspect a directory of active agents, programs/models, and activity

It’s designed for: FastMCP clients and CLI tools (Claude Code, Codex, Gemini CLI, Factory Droid, etc.) coordinating across one or more codebases.

From Idea Spark to Shipping Swarm

If a blank repo feels daunting, follow the field-tested workflow we documented in docs/planning/project_idea_and_guide.md (“Appendix: From Blank Repo to Coordinated Swarm”):

• Ideate fast: Write a scrappy email-style blurb about the problem, desired UX, and any must-have stack picks (≈15 minutes).
• Promote it to a plan: Feed that blurb to GPT-5 Pro (and optionally Grok4 Heavy / Opus 4.1) until you get a granular Markdown plan, then iterate on the plan file while it’s still cheap to change. The Markdown Web Browser sample plan shows the level of detail to aim for.
• Codify the rules: Clone a tuned AGENTS.md, add any tech-specific best-practice guides, and let Codex scaffold the repo plus Beads tasks straight from the plan.
• Spin up the swarm: Launch multiple Codex panes (or any agent mix), register each identity with Agent Mail, and have them acknowledge AGENTS.md, the plan document, and the Beads backlog before touching code.