jasonsum_gmail-mcp-server

🚀 Gmail 服务器用于模型上下文协议 (MCP)

本 MCP 服务器与 Gmail 深度集成，可实现电子邮件的发送、删除、阅读、撰写以及响应等操作，为用户提供便捷的邮件管理体验。

⚠️ 重要提示

此服务器允许 MCP 客户端读取、删除和发送电子邮件，但客户端在执行这些操作前会提示用户，保障用户操作的自主性。

点击查看相关链接

✨ 主要特性

该 MCP 服务器具备一系列实用工具，可高效处理各类邮件操作：

• send-email：向指定收件人地址发送电子邮件，需提供收件人电子邮箱地址、邮件主题和邮件内容，操作完成后返回状态和消息 ID。
• trash-email：将指定电子邮件移到废纸篓，只需输入自动生成的电子邮件 ID，操作成功后返回成功消息。
• mark-email-as-read：标记指定电子邮件为已读，输入电子邮件 ID 即可完成操作并获得成功消息。
• get-unread-emails：检索未读邮件，返回包含未读邮件 ID 的列表。
• read-email：检索指定电子邮件内容，输入电子邮件 ID 后返回包含邮件元数据的字典，并将该邮件标记为已读。
• open-email：在浏览器中打开指定电子邮件，输入电子邮件 ID 后返回成功消息并在默认浏览器中打开邮件。

📦 安装指南

Gmail API 设置

1. 创建新的 Google Cloud 项目
2. 启用 Gmail API
3. 配置 OAuth 同意屏幕
   • 选择 "外部"，且此应用程序不会发布。
   • 将个人电子邮件地址添加为 "测试用户"。
4. 添加 OAuth 范围 https://www.googleapis.com/auth/gmail/modify
5. 创建应用类型的 OAuth 客户端 ID，选择 "桌面应用程序"
6. 下载客户端的 OAuth 密钥文件（JSON 格式）
7. 重命名密钥文件并保存到本地计算机的安全位置，记住此路径，启动服务器时将通过参数 --creds 引用该路径。

认证

运行以下命令进行认证：

python -m gmail_mcp --creds path/to/your/credentials.json

此命令将打开默认浏览器窗口以完成 Google 的 OAuth 流程。完成后，会看到成功消息，且会在 path/to/your/credentials.json 位置创建一个 crets.json 文件。此时，您就可以使用 Gmail MCP 服务器了！