Gmail Server for Model Context Protocol (MCP)
2025.03.24
0
Python电子邮件管理Gmail集成交流协作
该MCP服务器与Gmail集成，支持发送、删除、阅读、起草和回复电子邮件。它允许MCP客户端读取、删除和发送电子邮件，但在执行这些操作前会提示用户确认。
View on GitHub
Overview
基本能力
产品定位
该MCP服务器旨在通过Gmail API提供电子邮件管理功能，使MCP客户端能够与Gmail服务进行交互。
核心功能
- 发送电子邮件
- 将电子邮件移至垃圾箱
- 标记电子邮件为已读
- 获取未读电子邮件列表
- 读取特定电子邮件内容
- 在浏览器中打开电子邮件
适用场景
- 自动化电子邮件管理
- 集成电子邮件功能到其他应用程序
- 批量处理电子邮件
工具列表
- 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（"Desktop App"类型）
- 下载JSON格式的客户端OAuth密钥
安装教程
- 将密钥文件重命名并保存在本地安全位置
- 记录文件位置（作为
--creds-file-path参数） - 准备令牌存储位置（作为
--token-path参数）
调试方式
使用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]