Python SMTP 邮件发送工具 - 支持附件与IMAP已发送同步 | SkillsMDPython SMTP 邮件发送工具 - 支持附件与IMAP已发送同步
email-smtp-send by tiangong-ai/skills
npx skills add https://github.com/tiangong-ai/skills --skill email-smtp-send🇨🇳中文介绍
电子邮件 SMTP 发送
核心目标
- 通过 SMTP 使用环境变量配置的凭据发送外发电子邮件。
- 根据请求将本地文件作为 MIME 电子邮件有效负载的附件。
- 可选地将已发送的消息追加到 IMAP 已发送邮箱，以实现跨客户端可见性。
- 在投递前验证 SMTP 和已发送邮件同步配置。
- 返回机器可读的 JSON 状态/错误输出。
工作流程
- 配置 SMTP 环境变量（参见
references/env.md 和 assets/config.example.env）。
- 可选：启用同步功能时，配置 IMAP 已发送邮件同步环境变量并安装
imapclient。
- 验证配置：
python3 scripts/smtp_send.py check-config
- 发送一封电子邮件：
python3 scripts/smtp_send.py send \
--to recipient@example.com \
--subject "SMTP test" \
--body "Hello from email-smtp-send"
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
python3 scripts/smtp_send.py send \
--to recipient@example.com \
--subject "Package delivery" \
--body "See attachments." \
--attach ./report.pdf \
--attach ./appendix.xlsx
python3 scripts/smtp_send.py send \
--to recipient@example.com \
--subject "Synced send" \
--body "This message will be appended to Sent Items." \
--sync-sent \
--sent-mailbox "Sent Items"
输出约定
check-config 打印经过清理的 SMTP 配置 + 默认值 + 已发送邮件同步配置 JSON。send 成功时打印一个 type=status JSON 对象，包含：
event=smtp_sent- 发件人、收件人摘要、主题、SMTP 主机/端口
message_idattachment_count 和 attachments[] 元数据sent_sync 对象，包含 enabled、required、appended 以及同步元数据/错误
send 失败时向 stderr 打印 type=error JSON，错误类型为以下之一：
event=smtp_send_invalid_argsevent=smtp_send_failedevent=smtp_sent_sync_failed（仅当同步为必需且同步失败时）
参数
send --to：必需的收件人，可重复指定或以逗号分隔。send --cc：可选的抄送收件人。send --bcc：可选的密送收件人。send --subject：可选的主题（默认为环境变量值）。send --body：可选的正文（默认为环境变量值）。send --content-type：plain 或 html。send --from：可选的发件人覆盖。send --attach：可选的本地附件路径，可重复指定或以逗号分隔。send --max-attachment-bytes：每个附件允许的最大字节数。send --message-id：可选的 Message-ID 头。send --in-reply-to：可选的 In-Reply-To 头。send --references：可选的 References 头。send --sync-sent|--no-sync-sent：为此次发送强制启用/禁用 IMAP 已发送邮件同步。send --sent-mailbox：覆盖已发送邮箱。send --sent-flags：IMAP APPEND 标志，逗号分隔（默认为 \Seen）。send --sent-sync-required：如果 SMTP 成功但已发送邮件同步失败，则返回非零值。
SMTP_HOST、SMTP_PORT、SMTP_SSL、SMTP_STARTTLSSMTP_USERNAME、SMTP_PASSWORD、SMTP_FROM、SMTP_CONNECT_TIMEOUTSMTP_SUBJECT、SMTP_BODY、SMTP_CONTENT_TYPESMTP_MAX_ATTACHMENT_BYTESSMTP_SYNC_SENT、SMTP_SYNC_SENT_REQUIREDSMTP_SENT_IMAP_HOST、SMTP_SENT_IMAP_PORT、SMTP_SENT_IMAP_SSLSMTP_SENT_IMAP_USERNAME、SMTP_SENT_IMAP_PASSWORDSMTP_SENT_IMAP_MAILBOX、SMTP_SENT_IMAP_FLAGS、SMTP_SENT_IMAP_CONNECT_TIMEOUT- 兼容性回退：
IMAP_HOST、IMAP_PORT、IMAP_SSL、IMAP_USERNAME、IMAP_PASSWORD、IMAP_CONNECT_TIMEOUT
依赖项
python3 -m pip install imapclient
错误处理
- 无效的环境配置以代码
2 退出。
- 发送失败以代码
1 退出。
- 如果同步是必需的（
--sent-sync-required 或 SMTP_SYNC_SENT_REQUIRED=true），同步失败以代码 1 退出。
参考
资源文件
assets/config.example.env
脚本
🇺🇸English
Email SMTP Send
Core Goal
- Send outbound email via SMTP with env-configured credentials.
- Attach local files into MIME email payload when requested.
- Optionally append the sent message to IMAP sent mailbox for cross-client visibility.
- Validate SMTP and sent-sync configuration before delivery.
- Return machine-readable JSON status/error output.
Workflow
- Configure SMTP env vars (see
references/env.md and assets/config.example.env).
- Optional: configure IMAP sent-sync env vars and install
imapclient when sync is enabled.
- Validate configuration:
python3 scripts/smtp_send.py check-config
- Send one email:
python3 scripts/smtp_send.py send \
--to recipient@example.com \
--subject "SMTP test" \
--body "Hello from email-smtp-send"
5. Send with attachments:
python3 scripts/smtp_send.py send \
--to recipient@example.com \
--subject "Package delivery" \
--body "See attachments." \
--attach ./report.pdf \
--attach ./appendix.xlsx
6. Send and sync to sent mailbox:
python3 scripts/smtp_send.py send \
--to recipient@example.com \
--subject "Synced send" \
--body "This message will be appended to Sent Items." \
--sync-sent \
--sent-mailbox "Sent Items"
Output Contract
check-config prints sanitized SMTP config + defaults + sent-sync config JSON.send success prints one type=status JSON object containing:
event=smtp_sent- sender, recipient summary, subject, SMTP host/port
message_idattachment_count and attachments[] metadatasent_sync object with enabled, required, , and sync metadata/error
Parameters
send --to: required recipient, repeatable or comma-separated.send --cc: optional CC recipients.send --bcc: optional BCC recipients.send --subject: optional subject (defaults from env).send --body: optional body (defaults from env).send --content-type: plain or html.send --from: optional sender override.send --attach: optional local attachment path, repeatable or comma-separated.
Environment defaults:
SMTP_HOST, SMTP_PORT, SMTP_SSL, SMTP_STARTTLSSMTP_USERNAME, SMTP_PASSWORD, SMTP_FROM, SMTP_CONNECT_TIMEOUTSMTP_SUBJECT, SMTP_BODY, SMTP_CONTENT_TYPE
Dependency
-
Sent-sync mode requires imapclient:
python3 -m pip install imapclient
Error Handling
- Invalid env config exits with code
2.
- Send failure exits with code
1.
- If sync is required (
--sent-sync-required or SMTP_SYNC_SENT_REQUIRED=true), sync failure exits with code 1.
References
Assets
assets/config.example.env
Scripts
Weekly Installs
220
Repository
tiangong-ai/skills
GitHub Stars
4
First Seen
Feb 23, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
cline218
github-copilot218
codex218
opencode218
kimi-cli217
gemini-cli217
agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试
147,400 周安装
appended
send failures print type=error JSON to stderr with one of:
event=smtp_send_invalid_argsevent=smtp_send_failedevent=smtp_sent_sync_failed (only when sync is required and sync fails)
send --max-attachment-bytes: max bytes allowed per attachment.send --message-id: optional Message-ID header.send --in-reply-to: optional In-Reply-To header.send --references: optional References header.send --sync-sent|--no-sync-sent: force-enable/disable IMAP sent sync for this send.send --sent-mailbox: override sent mailbox.send --sent-flags: IMAP APPEND flags, comma-separated (default \Seen).send --sent-sync-required: return non-zero if SMTP succeeds but sent sync fails.SMTP_MAX_ATTACHMENT_BYTESSMTP_SYNC_SENT, SMTP_SYNC_SENT_REQUIREDSMTP_SENT_IMAP_HOST, SMTP_SENT_IMAP_PORT, SMTP_SENT_IMAP_SSLSMTP_SENT_IMAP_USERNAME, SMTP_SENT_IMAP_PASSWORDSMTP_SENT_IMAP_MAILBOX, SMTP_SENT_IMAP_FLAGS, SMTP_SENT_IMAP_CONNECT_TIMEOUTcompatibility fallbacks: IMAP_HOST, IMAP_PORT, IMAP_SSL, IMAP_USERNAME, IMAP_PASSWORD, IMAP_CONNECT_TIMEOUT