mcpField
I
imap-smtp-email

imap-smtp-email

github.com/boomsystel-code生产力01.9k 次安装38 周前更新
代码仓库

关于 imap-smtp-email

IMAP/SMTP Email Tool 是通过 IMAP 读取和管理邮件、通过 SMTP 发送邮件的命令行工具，适用于使用常见邮件服务或标准邮件服务器的用户。它支持搜索、附件下载、邮件状态管理及多种发送内容。

主要功能

  1. 01检查、读取和搜索邮件
  2. 02下载邮件附件
  3. 03标记已读或未读
  4. 04通过 SMTP 发送邮件
  5. 05支持正文、抄送和附件

适用场景

  1. 01筛查近期未读邮件
  2. 02搜索并下载邮件附件
  3. 03从命令行发送报告邮件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/boomsystel-code/openclaw-workspace --skill imap-smtp-email

安装后在 Claude Code 中输入/imap-smtp-email确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

_meta.json
package.json
README.md
setup.sh
.clawhub/
origin.json
scripts/
imap.js
smtp.js

详细介绍

IMAP/SMTP 邮件工具

通过 IMAP 协议读取、搜索和管理邮件。通过 SMTP 发送邮件。支持 Gmail、Outlook、163.com、vip.163.com、126.com、vip.126.com、188.com、vip.188.com，以及任何标准 IMAP/SMTP 服务。

配置

在技能文件夹中创建 .env，或设置环境变量：

# IMAP Configuration (receiving email)
IMAP_HOST=imap.gmail.com          # Server hostname
IMAP_PORT=993                     # Server port
[email protected]
IMAP_PASS=your_password
IMAP_TLS=true                     # Use TLS/SSL connection
IMAP_REJECT_UNAUTHORIZED=true     # Set to false for self-signed certs
IMAP_MAILBOX=INBOX                # Default mailbox

# SMTP Configuration (sending email)
SMTP_HOST=smtp.gmail.com          # SMTP server hostname
SMTP_PORT=587                     # SMTP port (587 for STARTTLS, 465 for SSL)
SMTP_SECURE=false                 # true for SSL (465), false for STARTTLS (587)
[email protected]          # Your email address
SMTP_PASS=your_password           # Your password or app password
[email protected]          # Default sender email (optional)
SMTP_REJECT_UNAUTHORIZED=true     # Set to false for self-signed certs

常见邮件服务器

提供商IMAP 主机IMAP 端口SMTP 主机SMTP 端口
163.comimap.163.com993smtp.163.com465
vip.163.comimap.vip.163.com993smtp.vip.163.com465
126.comimap.126.com993smtp.126.com465
vip.126.comimap.vip.126.com993smtp.vip.126.com465
188.comimap.188.com993smtp.188.com465
vip.188.comimap.vip.188.com993smtp.vip.188.com465
yeah.netimap.yeah.net993smtp.yeah.net465
Gmailimap.gmail.com993smtp.gmail.com587
Outlookoutlook.office365.com993smtp.office365.com587
QQ Mailimap.qq.com993smtp.qq.com587

163.com 重要提示：

  • 使用授权码，而不是账户密码
  • 先在网页设置中启用 IMAP/SMTP

IMAP 命令（接收邮件）

check

检查新邮件/未读邮件。

node scripts/imap.js check [--limit 10] [--mailbox INBOX] [--recent 2h]

选项：

  • --limit <n>：最多返回的结果数（默认值：10）
  • --mailbox <name>：要检查的邮箱（默认值：INBOX）
  • --recent <time>：仅显示最近 X 时间内的邮件（例如：30m、2h、7d）
fetch

按 UID 获取完整邮件内容。

node scripts/imap.js fetch <uid> [--mailbox INBOX]
download

下载邮件中的所有附件或指定附件。

node scripts/imap.js download <uid> [--mailbox INBOX] [--dir <path>] [--file <filename>]

选项：

  • --mailbox <name>：邮箱（默认值：INBOX）
  • --dir <path>：输出目录（默认值：当前目录）
  • --file <filename>：仅下载指定附件（默认值：下载全部）
search

使用筛选条件搜索邮件。

node scripts/imap.js search [options]

Options:
  --unseen           Only unread messages
  --seen             Only read messages
  --from <email>     From address contains
  --subject <text>   Subject contains
  --recent <time>    From last X time (e.g., 30m, 2h, 7d)
  --since <date>     After date (YYYY-MM-DD)
  --before <date>    Before date (YYYY-MM-DD)
  --limit <n>        Max results (default: 20)
  --mailbox <name>   Mailbox to search (default: INBOX)
mark-read / mark-unread

将邮件标记为已读或未读。

node scripts/imap.js mark-read <uid> [uid2 uid3...]
node scripts/imap.js mark-unread <uid> [uid2 uid3...]
list-mailboxes

列出所有可用邮箱/文件夹。

node scripts/imap.js list-mailboxes

SMTP 命令（发送邮件）

send

通过 SMTP 发送邮件。

node scripts/smtp.js send --to <email> --subject <text> [options]

必填项：

  • --to <email>：收件人（多个收件人以逗号分隔）
  • --subject <text>：邮件主题，或使用 --subject-file <file>

可选项：

  • --body <text>：纯文本正文
  • --html：以 HTML 格式发送正文
  • --body-file <file>：从文件读取正文
  • --html-file <file>：从文件读取 HTML
  • --cc <email>：抄送收件人
  • --bcc <email>：密送收件人
  • --attach <file>：附件（以逗号分隔）
  • --from <email>：覆盖默认发件人

示例：

# Simple text email
node scripts/smtp.js send --to [email protected] --subject "Hello" --body "World"

# HTML email
node scripts/smtp.js send --to [email protected] --subject "Newsletter" --html --body "<h1>Welcome</h1>"

# Email with attachment
node scripts/smtp.js send --to [email protected] --subject "Report" --body "Please find attached" --attach report.pdf

# Multiple recipients
node scripts/smtp.js send --to "[email protected],[email protected]" --cc "[email protected]" --subject "Update" --body "Team update"
test

向自己发送测试邮件，以测试 SMTP 连接。

node scripts/smtp.js test

依赖项

npm install

安全说明

  • 将凭据存储在 .env 中（并将其添加到 .gitignore）
  • 对于 Gmail：启用两步验证时，请使用应用专用密码
  • 对于 163.com：使用授权码，而不是账户密码

故障排除

连接超时：

  • 确认服务器正在运行且可以访问
  • 检查主机/端口配置

身份验证失败：

  • 确认用户名正确（通常是完整的电子邮件地址）
  • 检查密码是否正确
  • 对于 163.com：使用授权码，而不是账户密码
  • 对于 Gmail：启用两步验证时，请使用应用专用密码

TLS/SSL 错误：

  • 根据服务器要求设置 IMAP_TLS/SMTP_SECURE
  • 对于自签名证书：设置 IMAP_REJECT_UNAUTHORIZED=false 或 SMTP_REJECT_UNAUTHORIZED=false

评论

支持 Markdown