Gmail MCP Server

Gmail MCP Server

Gmail-MCP-Server 是一个为 Claude Desktop 设计的 Gmail 自动认证工具,支持通过自然语言交互管理邮件,包括发送、搜索、标签管理、批量操作等功能,提升邮件管理效率。

60 浏览
2025-12-22 发布

详细介绍

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.com
  • to::搜索发送给特定收件人的邮件,如 to:mary@example.com
  • subject::搜索主题包含指定文字的邮件,如 subject:"meeting notes"
  • has:attachment:搜索带有附件的邮件
  • after::搜索在指定日期之后收到的邮件,如 after:2024/01/01
  • before::搜索在指定日期之前收到的邮件,如 before:2024/02/01
  • is::搜索特定状态的邮件,如 is:unread
  • label::搜索具有特定标签的邮件,如 label:work

标签管理

Gmail-MCP-Server 提供全面的标签管理功能,包括:

  • 创建自定义标签
  • 更新现有标签信息
  • 删除用户创建的标签
  • 获取所有系统和自定义标签列表

总结

Gmail-MCP-Server 是一个功能强大且易于使用的 Gmail 自动化管理工具,支持通过自然语言交互实现邮件的全面管理。无论是个人用户还是团队,都可以通过该工具提升邮件处理效率,实现自动化操作。

邮件管理 自动化工具 Gmail API 自然语言交互

相关服务推荐

查看更多