Gmail Server for Model Context Protocol (MCP)
2025.01.15
0
Python电子邮件管理自动化工具交流协作
Gmail MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，用于与 Gmail 集成，实现发送、删除、阅读、起草和回复电子邮件等功能。该服务允许 MCP 客户端在用户确认后执行这些操作。
View on GitHub
Overview
基本能力
产品定位
Gmail MCP Server 是一个电子邮件管理服务，通过 MCP 协议与 Gmail 集成，提供电子邮件的基本操作功能。
核心功能
- 发送电子邮件
- 将电子邮件移至垃圾箱
- 标记电子邮件为已读
- 获取未读电子邮件列表
- 阅读特定电子邮件内容
- 在浏览器中打开电子邮件
适用场景
- 自动化电子邮件管理
- 集成电子邮件功能到其他应用程序
- 批量处理电子邮件
工具列表
- send-email: 发送电子邮件到指定收件人
- trash-email: 将电子邮件移至垃圾箱
- mark-email-as-read: 标记电子邮件为已读
- get-unread-emails: 获取未读电子邮件列表
- read-email: 读取特定电子邮件内容
- open-email: 在浏览器中打开电子邮件
常见问题解答
- 问题：如何设置 Gmail API？ 解答：需要创建 Google Cloud 项目，启用 Gmail API，配置 OAuth 同意屏幕，并创建 OAuth 客户端 ID。
- 问题：如何进行身份验证？ 解答：服务器启动时会启动系统浏览器进行身份验证流程，令牌凭证将保存在指定的文件中。
使用教程
使用依赖
- 创建 Google Cloud 项目
- 启用 Gmail API
- 配置 OAuth 同意屏幕
- 创建 OAuth 客户端 ID
- 下载 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]