Gmail Server for Model Context Protocol (MCP)
2025.02.01
28
Python电子邮件管理自动化工具交流协作
Gmail Server for Model Context Protocol (MCP) 是一个与Gmail集成的MCP服务器，支持发送、删除、阅读、起草和回复电子邮件。该服务器允许MCP客户端读取、删除和发送电子邮件，但在执行这些操作前会提示用户确认。
View on GitHub
Overview
基本能力
产品定位
Gmail MCP服务器是一个用于电子邮件管理的工具，通过与Gmail API集成，提供了一系列操作电子邮件的功能。
核心功能
- 发送电子邮件：向指定收件人发送电子邮件。
- 删除电子邮件：将电子邮件移动到垃圾箱。
- 标记电子邮件为已读：更改电子邮件的阅读状态。
- 获取未读电子邮件：检索所有未读的电子邮件列表。
- 阅读电子邮件：获取指定电子邮件的详细内容和元数据。
- 在浏览器中打开电子邮件：在默认浏览器中打开指定的电子邮件。
适用场景
- 自动化电子邮件管理。
- 集成电子邮件功能到其他应用程序中。
- 批量处理电子邮件任务。
工具列表
- send-email：发送电子邮件。
- trash-email：将电子邮件移动到垃圾箱。
- mark-email-as-read：标记电子邮件为已读。
- get-unread-emails：获取未读电子邮件列表。
- read-email：阅读指定电子邮件。
- open-email：在浏览器中打开电子邮件。
常见问题解答
- 如何设置Gmail API？
- 如何配置OAuth同意屏幕？
- 如何测试服务器功能？
使用教程
使用依赖
- 创建一个新的Google Cloud项目。
- 启用Gmail API。
- 配置OAuth同意屏幕。
- 添加OAuth范围
https://www.googleapis.com/auth/gmail/modify。 - 为“桌面应用”创建OAuth客户端ID。
- 下载客户端OAuth密钥的JSON文件。
安装教程
- 使用uv运行服务器。
- 配置Claude Desktop的MCP服务器配置。
调试方式
使用MCP Inspector测试服务器功能。
npx @modelcontextprotocol/inspector uv run [absolute-path-to-git-repo]/src/gmail/server.py --creds-file-path [absolute-path-to-credentials-file] --token-path [absolute-path-to-access-tokens-file]