What problem does it solve?
AI Agents on platforms like Claude Code or Codex lack a unified way to send, receive, search, and organize email through dedicated Agent mailboxes, forcing ad-hoc per-provider scripting and manual handling of provider-specific quirks like OAuth and two-step confirmation.
Core Features & Use Cases
- Unified multi-provider API: A single set of
mail_* shell functions routes operations to NetEase ClawEmail (@clawemail/mail-cli) or Tencent Agent Mail (@tencent-qqmail/agently-cli) based on the MAIL_PROVIDER environment variable.
- Full mailbox operations: Send, list, read, search, reply, forward, trash, download attachments, and watch for new mail, with provider differences handled transparently.
- Automated two-step confirmation: Tencent write operations requiring a
ctk_xxx confirmation token are completed automatically inside the wrapper, while user confirmation stays at the conversation layer.
- Use Case: An Agent distributes a data-analysis task by email to another Agent, polls the inbox for replies, downloads returned attachments, and sends a summary report to a human contact.
Quick Start
Ask the Agent to configure a ClawEmail or Tencent Agent Mail account and then send an email to a specified recipient with a given subject and body.