How do I install the Email Assistant skill?

Run npx skillmds@latest add dvcrn/email-assistant in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Email Assistant safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Email Assistant?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Email Assistant free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Email Assistant?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Email Assistant by dvcrn — Agent Skill

Name: Email Assistant
Rating: 4.666666666666667 (3 reviews)
Author: dvcrn

Email Assistant

Multi-email management assistant supporting Gmail, 163, QQ, Outlook, and Hotmail. Features: (1) Fetch inbox and summarize emails (2) Keyword-based important email detection (3) Auto-extract calendar events from emails. Use when: users need unified email management across multiple accounts, want to avoid missing important emails, or need to extract schedules from email content.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

Email Assistant - 多邮箱管理助手

功能概览

多邮箱支持: Gmail、163、QQ、Outlook、Hotmail
邮件读取: 获取收件箱、显示摘要、搜索邮件
智能分析: 关键词识别重要邮件
日程提取: 自动从邮件中提取日程信息

支持的邮箱

邮箱	协议	服务器配置
Gmail	OAuth2 + IMAP	imap.gmail.com:993
163	IMAP	imap.163.com:993
QQ	IMAP	imap.qq.com:993
Outlook	IMAP	outlook.office365.com:993
Hotmail	IMAP	outlook.office365.com:993

使用方法

1. Gmail 配置

首次使用需要配置 OAuth：

# 1. 在 Google Cloud Console 创建项目
# 2. 启用 Gmail API
# 3. 创建 OAuth 2.0 客户端凭据
# 4. 下载凭据文件为 credentials.json
# 5. 首次运行会自动打开浏览器授权

运行脚本：

cd scripts
python3 gmail_client.py --credentials ../credentials.json

2. IMAP 邮箱 (163/QQ/Outlook/Hotmail)

直接运行：

python3 imap_client.py --server <服务器> --email <邮箱> --password <密码或App密码>

3. 查看邮件

# 查看收件箱
python3 mail_parser.py --inbox

# 搜索特定邮件
python3 mail_parser.py --search "关键词"

# 分析重要邮件
python3 mail_parser.py --analyze

4. 提取日程

# 从邮件中提取日程并生成 ICS 文件
python3 scheduler.py --extract --output events.ics

脚本说明

scripts/gmail_client.py

Gmail OAuth 认证客户端。首次运行会打开浏览器进行授权，之后凭据会缓存。

scripts/imap_client.py

通用 IMAP 客户端，适用于 163、QQ、Outlook、Hotmail。使用 App Password 认证。

scripts/mail_parser.py

邮件解析器。解析纯文本/HTML 邮件，提取关键信息，分析重要性。

scripts/scheduler.py

日程提取器。从邮件中识别 iCal 附件或纯文本日程，生成标准 ICS 日历文件。

重要邮件识别

自动识别以下关键词：

urgent, 紧急, 重要, 即时
deadline, 截止, 期限
meeting, 会议, 面试
invoice, 发票, 付款, 账单
contract, 合同, 协议

日程提取

支持格式：

iCal 附件 (.ics)
纯文本日程（日期+时间+内容）

注意事项

Gmail: 必须使用 OAuth2，密码登录已被禁用
163/QQ: 需开启 IMAP 并使用 App Password
Outlook/Hotmail: 使用常规密码或 App Password
建议使用 App Password 而非登录密码，提高安全性

---name: email-assistantdescription: Multi-email management assistant supporting Gmail, 163, QQ, Outlook, and Hotmail. Features: (1) Fetch inbox and summarize emails (2) Keyword-based important email detection (3) Auto-extract calendar events from emails. Use when: users need unified email management across multiple accounts, want to avoid missing important emails, or need to extract schedules from email content.---# Email Assistant - 多邮箱管理助手## 功能概览- **多邮箱支持**: Gmail、163、QQ、Outlook、Hotmail- **邮件读取**: 获取收件箱、显示摘要、搜索邮件- **智能分析**: 关键词识别重要邮件- **日程提取**: 自动从邮件中提取日程信息## 支持的邮箱| 邮箱 | 协议 | 服务器配置 ||------|------|-----------|| Gmail | OAuth2 + IMAP | imap.gmail.com:993 || 163 | IMAP | imap.163.com:993 || QQ | IMAP | imap.qq.com:993 || Outlook | IMAP | outlook.office365.com:993 || Hotmail | IMAP | outlook.office365.com:993 |## 使用方法### 1. Gmail 配置首次使用需要配置 OAuth：```bash# 1. 在 Google Cloud Console 创建项目# 2. 启用 Gmail API# 3. 创建 OAuth 2.0 客户端凭据# 4. 下载凭据文件为 credentials.json# 5. 首次运行会自动打开浏览器授权```运行脚本：```bashcd scriptspython3 gmail_client.py --credentials ../credentials.json```### 2. IMAP 邮箱 (163/QQ/Outlook/Hotmail)直接运行：```bashpython3 imap_client.py --server <服务器> --email <邮箱> --password <密码或App密码>```### 3. 查看邮件```bash# 查看收件箱python3 mail_parser.py --inbox# 搜索特定邮件python3 mail_parser.py --search "关键词"# 分析重要邮件python3 mail_parser.py --analyze```### 4. 提取日程```bash# 从邮件中提取日程并生成 ICS 文件python3 scheduler.py --extract --output events.ics```## 脚本说明### scripts/gmail_client.pyGmail OAuth 认证客户端。首次运行会打开浏览器进行授权，之后凭据会缓存。### scripts/imap_client.py通用 IMAP 客户端，适用于 163、QQ、Outlook、Hotmail。使用 App Password 认证。### scripts/mail_parser.py邮件解析器。解析纯文本/HTML 邮件，提取关键信息，分析重要性。### scripts/scheduler.py日程提取器。从邮件中识别 iCal 附件或纯文本日程，生成标准 ICS 日历文件。## 重要邮件识别自动识别以下关键词：- urgent, 紧急, 重要, 即时- deadline, 截止, 期限- meeting, 会议, 面试- invoice, 发票, 付款, 账单- contract, 合同, 协议## 日程提取支持格式：- iCal 附件 (.ics)- 纯文本日程（日期+时间+内容）## 注意事项1. **Gmail**: 必须使用 OAuth2，密码登录已被禁用2. **163/QQ**: 需开启 IMAP 并使用 App Password3. **Outlook/Hotmail**: 使用常规密码或 App Password4. 建议使用 App Password 而非登录密码，提高安全性

Frequently asked questions