**Email은 AI 에이전트가 실제로 작동 할 수 있기 때문에. ** Gmail, QQ, 163, Outlook 및 IMAP / SMTP 상자 - 모든 명령은 JSON, 모든 파괴를 말한다 --confirm]를 통과할 때까지 건조한 실행입니다.

*-use 가족의 일부 - 각 작은 도구는 에이전트를 제공합니다 손 에 한 현실 일.

왜 이가 아닌 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을 의미하는 스냅 샷 syncing"는 살아있는 fetch의 호의로 거부됩니다. 빈 inbox는 결코 침묵하지 않습니다. “노스팅 도착”
• ** 동의에 의해 파괴. ** delete] / mark] / move] / send] 반환 Dry-run 미리보기 - 계정 및 폴더 당 그룹화, 샘플 주제 - 및 변경 --confirm]까지 아무것도. --all-folders는 요청하지 않는 Sent/Drafts/Junk/Trash를 건너.
• ** 토큰 예산에 대한 예산.** --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