Gmail-digester

通过 IMAP 拉取昨天与今天的未读邮件（发件人、主题、日期、正文），逐封生成一句话中文摘要，整理成统一格式的邮件摘要消息，经宿主消息工具发送；凭据支持环境变量或 JSON 配置文件两种方式。

2p1c

热度 64.65

最近更新 2026-05-11 17:29:08

分类：协作依赖：代码执行 / 读写文件 / 第三方 API / 内部调用大模型应用场景：摘要总结 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add gmail-summarize

Metadata

name: gmail-summarize
description: Fetch recent unread Gmail (yesterday + today) and send a digest to the user.
metadata: {"skill":{"emoji":"📬","requires":{"runtime":"python3","env_vars":{"required":["IMAP_USERNAME","IMAP_PASSWORD"],"optional":["IMAP_HOST","IMAP_PORT","IMAP_MAX_BODY_CHARS","EMAIL_CONFIG_PATH"]},"credentials":["IMAP_USERNAME (env, required) — IMAP login username","IMAP_PASSWORD (env, required) — IMAP login password / app-password","IMAP_HOST (env, optional, default: imap.gmail.com)","IMAP_PORT (env, optional, default: 993)"],"config":"$EMAIL_CONFIG_PATH or ~/.config/gmail-summarize/config.json (used only when IMAP_USERNAME/IMAP_PASSWORD env vars are absent)","config_fields":["email.imapHost","email.imapPort","email.imapUsername","email.imapPassword"],"external_connections":["IMAP server specified in IMAP_HOST or email.imapHost"]}}}

Gmail Recent Digest

Requirements

Python 3 must be available in the container environment (python command).
IMAP credentials must be supplied via one of the following methods (env vars take precedence):

Option A — Environment variables (recommended)

Variable	Description	Default
`IMAP_HOST`	IMAP server hostname	`imap.gmail.com`
`IMAP_PORT`	IMAP server port	`993`
`IMAP_USERNAME`	IMAP login username	(required)
`IMAP_PASSWORD`	IMAP login password / app-password	(required)
`IMAP_MAX_BODY_CHARS`	Max body characters per email	`2000`

Option B — Config file

Set EMAIL_CONFIG_PATH to point to a JSON file, or place the file at ~/.config/gmail-summarize/config.json. The file must contain only the fields below (no other sensitive data should be stored in this file):

{
  "email": {
    "imapHost": "imap.gmail.com",
    "imapPort": 993,
    "imapUsername": "your@gmail.com",
    "imapPassword": "your-app-password",
    "maxBodyChars": 2000
  }
}

Security notes

Preferred: supply credentials via environment variables (IMAP_HOST, IMAP_PORT, IMAP_USERNAME, IMAP_PASSWORD) so no file on disk is read at all.
When a config file is used, it should contain only the email fields listed above. The script reads only those four fields and nothing else from the file.
The only external connection made is to the IMAP server declared in IMAP_HOST / email.imapHost. No other endpoints are contacted.
Credentials are used solely to authenticate the IMAP session and are not logged or stored elsewhere by this skill.

When to use

User asks "check my Gmail", "summarize my emails", "邮件摘要"
Cron trigger message contains "gmail_digest"

Workflow

Run the fetch script via exec tool: python {workspace}/skills/gmail-summarize/scripts/fetch_unseen.py (replace {workspace} with your actual workspace root)
Parse the JSON array. Each item has: sender, subject, date, body
For each email compose one line: [date] sender | subject — one-sentence body summary
Send the full digest via MessageTool in this format:

📬 邮件摘要 (N封，覆盖 MM/DD–MM/DD)

• [日期] 发件人 | 主题 — 一句话摘要 • [日期] 发件人 | 主题 — 一句话摘要 ...
If result is empty, send: 📭 近两日暂无未读邮件

Output Rules

Send the digest message ONLY. Do NOT add any extra comments, greetings, explanations, or follow-up questions before or after the digest.
Do NOT say things like "主人，以下是您的邮件摘要" or "如需了解详情请告知" etc.
The digest message itself is the complete and final response.
The one-sentence body summary MUST be translated into Chinese. Sender names and subjects should keep their original text as-is.