mcpField
E
email

email

github.com/countbot-aiProductivity78337 installsUpdated 3d ago
Repository

About email

A skill for managing QQ or 163 email through command-line scripts, including sending, receiving, and handling attachments. Deletion behavior depends on the mailbox protocol.

Key features

  1. 01Send emails and attachments
  2. 02Receive recent emails
  3. 03Choose a default mailbox
  4. 04Delete emails by protocol

Use cases

  1. 01Send notices or reports from the command line
  2. 02Retrieve recent messages
  3. 03Manage mail in QQ or 163

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/countbot-ai/countbot --skill email

After installing, type/emailin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

scripts/
config.json
config.json.example
email_manager.py
mail.py

Details

From the project README

邮件管理

通过 QQ 或 163 邮箱发送和接收邮件。

配置

编辑 skills/email/scripts/config.json，填写邮箱地址和授权码（非登录密码）。

授权码获取：

  • QQ 邮箱：设置 > 账户 > 开启 IMAP/SMTP > 生成授权码
  • 163 邮箱：设置 > POP3/SMTP/IMAP > 开启服务 > 设置授权密码

可通过 default_mailbox 字段设置默认邮箱（"qq" 或 "163"）。

命令行调用

# 发送邮件
python3 skills/email/scripts/mail.py send --to [email protected] --subject "主题" --content "内容"

# 发送带附件
python3 skills/email/scripts/mail.py send --to [email protected] --subject "报告" --content "请查收" --attach report.pdf

# 接收最新邮件
python3 skills/email/scripts/mail.py receive --limit 5

# 接收邮件（JSON 输出，推荐 AI 使用）
python3 skills/email/scripts/mail.py receive --limit 5 --json

# 检查新邮件（最近 N 天）
python3 skills/email/scripts/mail.py check-new --since 1

# 检查新邮件（JSON 输出）
python3 skills/email/scripts/mail.py check-new --since 1 --json

# 删除邮件（移到已删除文件夹，QQ邮箱可恢复）
python3 skills/email/scripts/mail.py delete --ids 123

# 批量删除
python3 skills/email/scripts/mail.py delete --ids 123 124 125

# 彻底删除（不可恢复）
python3 skills/email/scripts/mail.py delete --ids 123 --permanent

# 指定邮箱类型
python3 skills/email/scripts/mail.py --mailbox 163 send --to [email protected] --subject "测试"

删除邮件说明

  • QQ 邮箱（IMAP）：默认移到「已删除」文件夹，可以从已删除中恢复。加 --permanent 彻底删除。
  • 163 邮箱（POP3）：POP3 协议不支持文件夹操作，删除始终是永久的，不可恢复。

Comments

Markdown supported