Bulk mark and delete by sender or subject is the feature that turns inbox cleanup into one instruction instead of a loop over message IDs. Destructive actions default to a dry-run preview and require a confirm flag, which is the right posture for handing an agent access to real mail.
A CLI-first, multi-account email tool with a local sync cache, shipping an optional MCP server so an agent can list, read, mark and delete mail.
- List and read mail across accounts, filtering by sender or subject against the local cache
- Mark read and delete, with a dry-run to validate before it touches the mailbox
- Bulk actions by sender or subject, so you do not need a list of message IDs
- Built-in providers for 163, QQ Mail, Gmail and Outlook/Hotmail, plus custom IMAP servers
- A local sync cache so listing does not hit IMAP every time; --live forces a fresh fetch
The mailbox binary — installed via the GitHub Releases install script (macOS arm64/x64, Linux x64), no Node required for end users. Account credentials go in ~/.config/mailbox/auth.json. The MCP server is generated with mailbox mcp config --json, which prints a paste-ready client entry. Deletes require a confirm flag.
One command plus a key — curl -fsSL https://raw.githubusercontent.com/leeguooooo/Mailbox/main/install.sh | sh, then supply credentials