⚡

Gmail邮件管理技能Skill gmail

这个技能提供了一套基于 Gmail API 的工具，用于自动化邮件管理任务，包括邮件读取、发送、搜索、删除、标签组织和批量操作。适用于集成到应用程序、自动化工作流和邮件处理优化。关键词：Gmail API、邮件自动化、邮件管理工具、电子邮件处理、批量操作、标签管理。

后端开发 0 次安装 0 次浏览 更新于 3/11/2026

名称: gmail 描述: 读取、发送、起草、删除和组织 Gmail 邮件

Gmail

可用工具

  • list_labels(): 列出所有 Gmail 标签（系统标签：INBOX、SENT、TRASH、SPAM、DRAFT、IMPORTANT、STARRED、UNREAD；加上用户创建的标签）。

  • list_emails(label?, max_results?, include_spam_trash?): 按标签列出邮件。

    • label（字符串，可选，默认：“INBOX”）：用于过滤的标签（INBOX、SENT、DRAFT、TRASH、SPAM、STARRED、IMPORTANT 或自定义标签 ID）
    • max_results（整数，可选，默认：10，最大：100）：返回的邮件数量
    • include_spam_trash（布尔值，可选，默认：false）：是否包含 SPAM 和 TRASH

  • search_emails(query, max_results?): 使用查询语法搜索 Gmail。

    • query（字符串，必需）：Gmail 搜索查询（from:、to:、subject:、is:unread、has:attachment、after:、before:、older_than:、newer_than:）
    • max_results（整数，可选，默认：10，最大：50）：结果数量

  • read_email(message_id): 读取完整邮件，包括正文和附件。

    • message_id（字符串，必需）：Gmail 邮件 ID（来自 list_emails 或 search_emails）

  • send_email(to, subject, body, cc?, bcc?, reply_to?, in_reply_to?, html_body?): 发送邮件。

    • to（字符串，必需）：收件人（多个用逗号分隔）
    • subject（字符串，必需）：邮件主题
    • body（字符串，必需）：纯文本邮件正文
    • cc（字符串，可选）：抄送收件人
    • bcc（字符串，可选）：密送收件人
    • reply_to（字符串，可选）：回复地址
    • in_reply_to（字符串，可选）：要回复的 Message-ID（用于线程化）
    • html_body（字符串，可选）：HTML 版本的邮件正文

  • draft_email(to, subject, body, cc?, bcc?, reply_to?, in_reply_to?, html_body?): 创建草稿以供后续编辑/发送。参数与 send_email 相同。

  • delete_email(message_id, permanent?): 删除邮件。

    • message_id（字符串，必需）：Gmail 邮件 ID
    • permanent（布尔值，可选，默认：false）：如果为 true，永久删除；如果为 false，移至垃圾箱

  • bulk_delete_emails(query, reason, max_delete?): 永久删除符合查询条件的多个邮件。无法撤销。

    • query（字符串，必需）：Gmail 搜索查询以查找邮件
    • reason（字符串，必需）：人类可读的解释（显示给用户以获得批准）
    • max_delete（整数，可选，默认：50，最大：100）：最大删除邮件数量

  • modify_email(message_id, add_labels?, remove_labels?): 在邮件上添加/删除标签。

    • message_id（字符串，必需）：Gmail 邮件 ID
    • add_labels（字符串，可选）：要添加的标签 ID，用逗号分隔（例如：“STARRED,IMPORTANT”）
    • remove_labels（字符串，可选）：要删除的标签 ID，用逗号分隔（例如：“UNREAD,INBOX”）

  • get_email_thread(thread_id): 获取电子邮件线程/对话中的所有消息。

    • thread_id（字符串，必需）：Gmail 线程 ID（来自 read_email 或 search_emails）

使用指南

  • 在使用过滤前，先使用 list_labels 发现可用标签。
  • Gmail 搜索查询语法：from:发件人、to:收件人、subject:文本、is:unread、has:attachment、after:2024/01/01、before:2024/12/31。
  • 在回复前，使用 get_email_thread 查看完整对话上下文。

常见操作

通过 modify_email 进行标签操作：

操作 参数
标记为已读 remove_labels="UNREAD"
标记为未读 add_labels="UNREAD"
归档 remove_labels="INBOX"
加星标 add_labels="STARRED"
取消星标 remove_labels="STARRED"
标记为重要 add_labels="IMPORTANT"

批量删除

bulk_delete_emails(query, reason) 永久删除所有符合 Gmail 查询条件的邮件。这无法撤销。

  • 始终提供 reason 参数解释意图。
  • 始终解释将删除的内容，并在调用前获取用户确认。

常见查询：

  • 垃圾邮件清理："is:spam older_than:7d"
  • 旧未读邮件："in:inbox is:unread older_than:14d"
  • 促销邮件清除："category:promotions older_than:30d"
  • 来自特定发件人："from:noreply@example.com older_than:30d"