详细介绍
Gmail-MCP-Server 是一个专为 Claude Desktop 设计的 Gmail 自动认证服务器工具,支持通过自然语言交互实现邮件的全面管理。该工具集成了 Gmail API,提供发送邮件、搜索邮件、标签管理、批量操作等核心功能,适用于需要自动化邮件处理的用户和团队。
核心功能
Gmail-MCP-Server 提供了丰富的邮件管理功能,包括:
- 发送邮件:支持发送带有主题、正文、附件和收件人的新邮件。
- 草稿邮件:创建未发送的草稿邮件。
- 读取邮件:根据邮件 ID 获取特定邮件的完整内容。
- 搜索邮件:使用 Gmail 的高级搜索语法查找邮件。
- 修改邮件标签:添加或移除邮件的标签,如归档、移动到其他文件夹。
- 删除邮件:永久删除指定邮件。
- 列出所有标签:查看系统和自定义的所有标签。
- 创建标签:支持创建新的 Gmail 标签。
- 批量修改邮件:对多封邮件执行高效的批量操作。
此外,工具还支持国际字符,确保邮件内容无乱码,并与 Gmail API 深度整合,功能强大且稳定。
安装方法
Gmail-MCP-Server 可通过多种方式安装,以下是主要的安装步骤:
pip install google.oauth2 googleapiclient gmail-mcp
安装完成后,需要创建一个 YAML 配置文件:
mkdir -p ~/.gmail-mcp && touch ~/.gmail-mcp/config.yaml
然后运行以下命令启动 OAuth 认证流程:
python -m gmail_mcp.auth
按照提示完成 Google 的 OAuth 同意流程。
使用方法
安装并配置完成后,可以通过命令行或集成到 Claude Desktop 中使用 Gmail-MCP-Server。以下是几个常见的使用示例:
send_email('会议提醒', '请记得参加明天上午10点的会议', ['recipient@example.com'])
search_emails('from:sender@example.com has:attachment')
batch_delete_emails(['msg123', 'msg456', 'msg789'])
在 Claude Desktop 中配置 MCP 服务器地址的示例如下:
{
"mcpServers": {
"gmail": {
"command": "npx",
"args": ["@gongrzhe/server-gmail-autoauth-mcp"]
}
}
}
使用场景
Gmail-MCP-Server 适用于以下场景:
- 需要自动化处理大量邮件的用户,如批量发送、归档、删除等。
- 希望使用自然语言与 AI 交互管理邮件的用户。
- 团队协作中需要统一邮件管理策略的场景。
- 开发者或系统管理员希望通过脚本实现邮件管理自动化。
注意事项
使用 Gmail-MCP-Server 时需注意以下事项:
- 需要网络连接才能正常工作。
- 初次使用时需要配置 Google Cloud 项目及 OAuth 凭据。
- 所有 API 请求均通过 SSL 加密通道传输,确保数据安全。
- 若认证失败,需确保 OAuth 令牌有效且未过期。
- 若搜索结果为空,可验证搜索条件是否正确。
高级搜索语法
Gmail-MCP-Server 支持 Gmail 的高级搜索语法,以下是一些常用运算符及其示例:
from::搜索来自特定发件人的邮件,如from:john@example.comto::搜索发送给特定收件人的邮件,如to:mary@example.comsubject::搜索主题包含指定文字的邮件,如subject:"meeting notes"has:attachment:搜索带有附件的邮件after::搜索在指定日期之后收到的邮件,如after:2024/01/01before::搜索在指定日期之前收到的邮件,如before:2024/02/01is::搜索特定状态的邮件,如is:unreadlabel::搜索具有特定标签的邮件,如label:work
标签管理
Gmail-MCP-Server 提供全面的标签管理功能,包括:
- 创建自定义标签
- 更新现有标签信息
- 删除用户创建的标签
- 获取所有系统和自定义标签列表
总结
Gmail-MCP-Server 是一个功能强大且易于使用的 Gmail 自动化管理工具,支持通过自然语言交互实现邮件的全面管理。无论是个人用户还是团队,都可以通过该工具提升邮件处理效率,实现自动化操作。