Gmail Plugin MCP Server
2025.03.23
0
Python电子邮件管理Gmail集成交流协作
Gmail Plugin MCP Server 是一个强大的 MCP 服务器，实现了 Gmail 集成功能，允许用户通过 MCP 客户端直接管理电子邮件。该插件提供了对 Gmail 核心功能的无缝访问，包括阅读、发送和管理电子邮件。
View on GitHub
Overview
基本能力
产品定位
Gmail Plugin MCP Server 是一个用于集成 Gmail 功能的 MCP 服务器，旨在通过 MCP 客户端提供电子邮件管理功能。
核心功能
- 📧 发送和接收电子邮件
- 📥 阅读未读邮件
- 🗑️ 将邮件移至垃圾箱
- 📱 在浏览器中打开邮件
- 📝 将邮件标记为已读
- 🔒 安全的 OAuth2 认证
适用场景
- 通过 MCP 客户端管理 Gmail 邮件
- 自动化电子邮件处理流程
- 集成 Gmail 功能到其他应用程序中
工具列表
| 工具名称 | 描述 | 必需参数 |
|---|---|---|
send-email |
发送电子邮件 | recipient_id, subject, message |
get-unread-emails |
获取未读邮件 | None |
read-email |
阅读邮件内容 | email_id |
trash-email |
将邮件移至垃圾箱 | email_id |
mark-email-as-read |
将邮件标记为已读 | email_id |
open-email |
在浏览器中打开邮件 | email_id |
常见问题解答
- 如何配置 Gmail API 凭证？
- 访问 Google Cloud Console
- 创建或选择现有项目
- 启用 Gmail API
- 配置 OAuth 同意屏幕
- 创建 OAuth 2.0 凭证
- 下载 JSON 凭证文件
使用教程
使用依赖
- Python 3.12 或更高版本
- Gmail API 凭证
- MCP 客户端（如 Claude Desktop）
安装教程
- 克隆仓库：
git clone https://github.com/yourusername/gmail-plugin.git
cd gmail-plugin
- 安装依赖（选择一种方法）：
# 方法1：以可编辑模式安装
uv pip install -e .
# 方法2：使用 requirements.txt 安装
uv pip install -r requirements.txt
# 方法3：使用 uv sync 安装（推荐）
uv sync --dev --all-extras
- 配置 Gmail API 凭证（见常见问题解答）
调试方式
使用 MCP Inspector 进行调试：
npx @modelcontextprotocol/inspector uv --directory C:\Users\sanch\Desktop\gmail_plugin\gmail-plugin run gmail-plugin