※メールは、AIエージェントが実際に操作できるものとして動作します。** Gmail、QQ、 163、Outlook および IMAP/SMTP ボックス — すべてのコマンドは、JSON をすべての破壊的に話します --confirm を渡すまでは、ドライランです。

[*-useの部分 - それぞれのエージェントを与える小さなツール 1つの本物に手を加える。

##IMAPスニペットではない理由

• 安定したJSON契約、スクレイピングされたテキストではありません。 あらゆる応答は運びます [success: boolean, 固定セットから[error_code]を強制終了 ([auth_failed]), [folder_not_found], [[imap_error], …). ドキュメント [docs/CLI_JSON_CONTRACT.md].
• 間違っているかもしれないとき、それはあなたに伝えます。 キャッシュバックレポート from_cache, [cache_age_secondsとcache_stale]、および "nothing を意味するのに十分なスナップショット 同期」はライブフェッチのお気に入りで拒否されます。 空の受信トレイは無声です 「到着しない」 -** delete / [mark] / [move] / [[send]) ドライランプレビュー — 1 つのアカウントとフォルダーごとにグループ化し、サンプルの件名と変更 [--confirmまでは何もありません。 [--all-folders]]は、Sent/Drafts/Junk/Trashを尋ねない限りスキップします。
• トークンの予算のためのBuilt。 --format compactは10に各電子メールをプロジェクト

mail-use

Email, as something an AI agent can actually operate. One CLI over Gmail, QQ, 163, Outlook and any IMAP/SMTP box — every command speaks JSON, every destructive one is dry-run until you pass --confirm.

mail-use code --json          # the newest verification code, one live pass
mail-use email recent --format compact --json
mail-use email delete --from [email protected] --confirm --json

Part of the *-use family — small tools that each give an agent hands on one real thing.

Why this and not an IMAP snippet

• A stable JSON contract, not scraped text. Every response carries success: boolean, and failures carry error_code from a fixed set (auth_failed, folder_not_found, imap_error, …). Documented in docs/CLI_JSON_CONTRACT.md.
• It tells you when it might be wrong. Cached reads report from_cache, cache_age_seconds and cache_stale, and a snapshot old enough to mean “nothing is syncing” is refused in favour of a live fetch. An empty inbox is never a silent “nothing arrived”.
• Destructive by consent only. delete / mark / move / send return a dry-run preview — grouped per account and folder, with sample subjects — and change nothing until --confirm. --all-folders skips Sent/Drafts/Junk/Trash unless asked.
• Built for token budgets. --format compact projects each email to the ten fields worth scanning (~30% smaller than the full shape), --with-preview folds a body snippet into the list call, and batch show reuses one IMAP connection.
• Fast enough to call in a loop. A persistent daemon pools IMAP connections and syncs to local SQLite in the background: five sequential email list calls go from 25s to 0.83s. See the table below.
• MCP too. mail-use mcp config --json prints a paste-ready entry; the server exposes 16 tools with the same dry-run defaults.

Renamed from Mailbox to mail-use. The command is now mail-use; mailbox still works as an alias, and your config in ~/.config/mailbox is untouched.

Supported providers

163 / 126 · QQ · Gmail · Outlook / Hotmail · any custom IMAP+SMTP server.

Search behaves differently per provider and the CLI says so: Gmail searches bodies server-side via X-GM-RAW, while QQ/163/Outlook have broken IMAP TEXT search, so --query falls back to matching subject + sender only. Use --from / --subject there for predictable results.

Install

One line, no npm, no Node

curl -fsSL https://raw.githubusercontent.com/leeguooooo/mail-use/main/install.sh | sh
mail-use --help

Downloads the prebuilt binary for your platform (macOS arm64/x64, Linux x64/arm64) from the latest GitHub Release, verifies its checksum, and installs to ~/.local/bin. Pin a version with MAIL_USE_VERSION=v2.11.2, or