| name | smtp-mail-assistant |
| description | Send and read emails through SMTP and POP3 from one-line natural language commands. Use when users ask to quickly send a mail ("发邮件给...") or check inbox mail ("查看最近N封邮件"), or when a ready-to-run Bun/JS CLI mail assistant with 163 Mail compatible defaults is needed. |
SMTP Mail Assistant
Overview
Run scripts/mail_assistant.mjs with Bun to parse one sentence into a send/list action and execute it with SMTP (send) + POP3 (read). Zero dependencies.
Workflow
- Credentials load automatically from
~/.env/smtp-mail-assistant.env (KEY=VALUE lines):
MAIL_ASSISTANT_AUTH_CODE=xxxx
# MAIL_ASSISTANT_EMAIL=toolkit_t@163.com # optional, default sender
Process env vars take precedence over the file. Override the file path with MAIL_ASSISTANT_ENV_FILE.
2. Run one sentence (see examples below).
3. Use --dry-run to verify parsing without network calls.
Command Rules
- Parse send commands from
给 <email> 发邮件 ... and 发邮件给 <email> ....
- Parse optional
主题 and 内容 segments; apply defaults when missing.
- Parse list commands from
查看/列出/显示/拉/拉取 ... 邮件; parse optional 最近N封 with max 50.
- If command contains
正文/详情/全文/body/detail/full, include full plain-text body in output.
Examples
Send Mail
bun scripts/mail_assistant.mjs "给 user@example.com 发邮件 主题 项目更新 内容 今天已完成接口联调"
bun scripts/mail_assistant.mjs "发邮件给 user@example.com 内容 你好，这是测试邮件"
List Inbox Mail
bun scripts/mail_assistant.mjs "查看邮件"
bun scripts/mail_assistant.mjs "查看最近8封邮件"
bun scripts/mail_assistant.mjs "拉最近5封邮件"
bun scripts/mail_assistant.mjs "查看最近2封邮件正文"
Dry Run (No Network)
bun scripts/mail_assistant.mjs "给 user@example.com 发邮件 主题 测试 内容 仅解析不发送" --dry-run
bun scripts/mail_assistant.mjs "查看最近3封邮件" --dry-run
Optional Flags
--email: override sender account, fallback to MAIL_ASSISTANT_EMAIL, then toolkit_t@163.com.--auth-code: override mail auth code, fallback to MAIL_ASSISTANT_AUTH_CODE.--smtp-host, --smtp-port: override SMTP endpoint.--pop3-host, --pop3-port: override POP3 endpoint.
Implementation Notes
- Use SMTP only for sending (
smtp.163.com:465 by default).
- Use POP3 for inbox reading (
pop.163.com:995 by default) because SMTP cannot fetch messages.
- Keep secrets out of source code; read credentials from CLI flags, environment variables, or
~/.env/smtp-mail-assistant.env.
