Gmail MCP Skill

Name: Gmail MCP
Rating: 76
Author: RayLee1997

使用 GongRzhe/Gmail-MCP-Server 发送邮件，支持附件功能。

前置条件

确保已完成 OAuth 配置，参考：发送邮件mcp工具.md

发送邮件（带附件）

1. 确认附件存在

发送附件前，先确认文件存在：

bash

ls -la <附件绝对路径>

2. 调用 send_email

参数格式：

json

{
  "to": ["recipient@example.com"],
  "subject": "邮件主题",
  "body": "邮件正文",
  "cc": ["cc@example.com"],
  "bcc": ["bcc@example.com"],
  "mimeType": "text/plain",
  "attachments": ["/absolute/path/to/file.pdf"]
}

参数说明

参数	类型	必填	说明
`to`	string[]	✅	收件人列表
`subject`	string	✅	邮件主题
`body`	string	✅	邮件正文
`cc`	string[]		抄送列表
`bcc`	string[]		密送列表
`mimeType`	string		`text/plain` / `text/html` / `multipart/alternative`
`htmlBody`	string		HTML 正文（multipart 时使用）
`attachments`	string[]		附件绝对路径列表

常见场景

场景 1：发送工作目录中的文件

code

用户：把 report.pdf 发给 boss@company.com

执行步骤：
1. find_by_name 搜索 "report.pdf"
2. 确认绝对路径如 /Users/ray/Projects/report.pdf
3. 调用 send_email：
   {
     "to": ["boss@company.com"],
     "subject": "今日报告",
     "body": "请查收附件",
     "attachments": ["/Users/ray/Projects/report.pdf"]
   }

场景 2：发送 HTML 邮件

json

{
  "to": ["marketing@example.com"],
  "subject": "季度报告",
  "mimeType": "text/html",
  "body": "<h1>Q4 报告</h1><p>详见附件</p>",
  "attachments": ["/Users/ray/Documents/Q4_Report.pdf"]
}

其他常用工具

搜索邮件

json

{"tool": "search_emails", "arguments": {"query": "from:sender@example.com", "maxResults": 10}}

读取邮件

json

{"tool": "read_email", "arguments": {"messageId": "182ab45cd67ef"}}

下载附件

json

{"tool": "download_attachment", "arguments": {"messageId": "182ab45cd67ef", "attachmentId": "ANGjdJ9...", "savePath": "/Users/ray/Downloads"}}