agent-mailbox - Mailbox and Wake System for AI Agent Teams MCP Server

A real mailbox for your AI agents - and you are the owner. Agents on different CLIs (Claude Code, Codex, Gemini CLI, Hermes, WorkBuddy…) message each other asynchronously on one machine, with delivery guarantees, wake-up calls, and a human-grade three-pane inbox where every conversation is visible. Zero dependencies, zero cloud, zero API keys. Its 14 documented tools cover mailbox, task.

People who work with mailbox and task and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-09-29 · ★ 2 · #36 OF 98 MAINTAINED EMAIL · VERIFIED 2026-09-30

MIT · Python servers · how we verify → /methodology

01 · Install agent-mailbox - Mailbox and Wake System for AI Agent Teams

before you install - you'll need

The README does not document required environment variables for a basic install.

Claude Code

claude mcp add polaris-smart-agent-mailbox -- uvx agent-mailbox

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "polaris-smart-agent-mailbox": {
      "command": "uvx",
      "args": [
        "agent-mailbox"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

repo age created 2026-09-08 - young repo, little track record yet

license MIT - declared in the repository

pypi package agent-mailbox - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.polaris-smart is GitHub-verified and matches the repo owner

03 · What agent-mailbox - Mailbox and Wake System for AI Agent Teams can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can fetch your pending messages (they become acked). Call at session start, list messages in your mailbox, optionally filtered by status and/or thread, list all registered agents and the mail root location, and create a task card (starts at todo). The assignee is auto-messaged.

Capability map

Tools grouped from the project's README - what agent-mailbox - Mailbox and Wake System for AI Agent Teams lets an agent do.

Mailbox

11 tools - e.g. Register this member and claim its mailbox. Idempotent - safe to call again.; Send a message to one agent, a list of agents, or "all" for broadcast.; Fetch your pending messages (they become acked). Call…

mailbox_register · mailbox_send · mailbox_check · mailbox_reply · mailbox_list · mailbox_thread…

Task

3 tools - e.g. Create a task card (starts at todo). The assignee is auto-messaged.; Move a task along todo→doing→review→done. Skips need force=True.; List task cards, optionally filtered by assignee and/or status.

task_create · task_move · task_list

Latest releases

v0.7.6 · 2026-09-30

v0.7.6 - 权限基座 + 状态可信 + 投递修复 + 入口档 · 权限基座 + 状态可信 + 投递修复版（A 组 11 条基座 + E/F/PR2/claim-first 五件；四平台同版本发布：PyPI + tag v0.7.6 + GitHub Release + MCP Registry republish）。 · Added · 权限基座（A 组，11 条）: tool-guard 全量 ToolError…

v0.7.5 · 2026-09-28

2026-09-26 · The trust-model release (PR A brand/CLI + PR B identity & permissions + PR C wizard/mailbox/visibility), merged with the 0.7.4 wake-hardening line (v07-sampling-wake) onto release/v0.7.5. Ships together…

v0.7.3 · 2026-09-28

2026-09-26 · Fixed · sdist hygiene, round two - the post-release artifact sweep (every release re-checks the published sdist from now on) caught scripts/wake-zc.sh, a machine-specific ops wrapper with hardcoded local…

04 · Who maintains agent-mailbox - Mailbox and Wake System for AI Agent Teams

agent-mailbox - Mailbox and Wake System for AI Agent Teams is maintained by polaris-smart. It's the only MCP server we track from this author; the repo dates to Sep 2026.

05 · Facts

repository: github.com/polaris-smart/agent-mailbox
category: email - ranked #36 of 98 actively-maintained email servers as of 2026-09-30.
release cadence: 10+ releases in the last 90 days (latest 2026-09-30)
registry: io.github.polaris-smart/agent-mailbox (active, first published 2026-09-28 · 2 versions)
packages: pypi:agent-mailbox

06 · agent-mailbox - Mailbox and Wake System for AI Agent Teams FAQ

Is agent-mailbox - Mailbox and Wake System for AI Agent Teams still maintained?

Yes - as of 2026-09-30, its last commit was 2026-09-29 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can agent-mailbox - Mailbox and Wake System for AI Agent Teams do?

How do I install agent-mailbox - Mailbox and Wake System for AI Agent Teams?

Run `uvx agent-mailbox`. The README does not document required environment variables for a basic install. You can also paste the ready-made client config above.

Does agent-mailbox - Mailbox and Wake System for AI Agent Teams run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to agent-mailbox - Mailbox and Wake System for AI Agent Teams

Alternatives to agent-mailbox - Mailbox and Wake System for AI Agent Teams

Maintained email servers if agent-mailbox - Mailbox and Wake System for AI Agent Teams isn't the fit.

More email MCP servers · Gmail (pulsemcp) · Redact MCP · Outlook · Notifyd · IntoDNS.ai DNS & Email Security Scanner

More Python MCP servers · PostHog MCP Server · Platform IO · Garmin Workouts MCP · Photographi MCP · Fetch V2 · see all