用途:全面管理 Gmail 邮件、标签与收件箱整理,适合发送或回复邮件、清理收件箱、按标签归档和查找邮件等场景。
前提条件:需安装并连接 Hyper MCP(https://app.hyperfx.ai/mcp),并在 https://app.hyperfx.ai/apps 启用 Gmail 集成。工具以规范名称调用:MCP 客户端(Claude、Cursor、Codex、ChatGPT)先 search("<想做的事>"),再 describe("<名称>"),最后 call("<名称>", {...});Hyper CLI 使用 hyperai search、hyperai describe <name>、hyperai call <name> --json '{...}'。若找不到工具,说明集成未连接或未在工作区启用,应停止并告知用户需连接哪个集成。
标签操作:gmail_labels_add 仅添加标签、不移动邮件;gmail_messages_move_to_label 会移除 INBOX 并加入目标标签(相当于移出收件箱);gmail_labels_remove 可移除指定标签(含 INBOX)。多数标签操作需要标签 ID 而非名称,应先调用 gmail_labels_list 获取,ID 形如 Label_123 或 INBOX、SENT、TRASH 等系统标签,不可猜测。
搜索与列表:gmail_messages_list 支持完整 Gmail 搜索语法,如 is:unread、from:user@example.com、has:attachment subject:invoice 及其组合,默认排除草稿,可用 label 参数过滤。
草稿与发送:gmail_drafts_create、gmail_drafts_update、gmail_drafts_send、gmail_drafts_list、gmail_drafts_get、gmail_drafts_delete。需立即发送用 gmail_messages_send;需先审阅或稍后发送用草稿流程。
归档与删除:gmail_messages_archive 移出 INBOX 但保留在 All Mail;gmail_messages_trash 移入垃圾箱,30 天后自动删除,清理收件箱优先用归档。附件通过 gmail_attachments_get 下载;发送带附件邮件需用 file_ids 参数且文件须先入库。
限制:资料未提供价格、支持平台范围及具体配额或效果数据。