Gmail 插件 MCP 服务器
强大的 MCP 服务器，支持 Gmail 集成，让您可以直接通过 MCP 客户端管理邮件。此插件可无缝访问 Gmail 的核心功能，包括阅读、发送和管理邮件。
参考：有关使用 uvx 的示例 MCP 服务器实现，请查看此示例。
🎥 演示
https://github.com/user-attachments/assets/df9e86cf-1f6b-4265-9c68-b3ed88103d1f
Related MCP server: @kazuph/mcp-gmail-gas
✨ 特点
📧 发送和接收电子邮件
📥 阅读未读消息
🗑️ 垃圾邮件
📱 在浏览器中打开电子邮件
📝 将电子邮件标记为已读
🔒 安全的 OAuth2 身份验证
🚀 快速入门
先决条件
Python 3.12 或更高版本
Gmail API 凭据
MCP 客户端（如 Claude Desktop）
安装
克隆存储库：
git clone https://github.com/yourusername/gmail-plugin.git
cd gmail-plugin安装依赖项（选择一种方法）：
# Method 1: Install in editable mode
uv pip install -e .
# Method 2: Install using requirements.txt
uv pip install -r requirements.txt
# Method 3: Install using uv sync (recommended)
uv sync --dev --all-extras配置您的 Gmail API 凭据：
创建新项目或选择现有项目
启用 Gmail API
配置 OAuth 同意屏幕：
选择“外部”用户类型（无需发布）
转到“受众”选项卡：将您的电子邮件添加为“测试用户”
添加 OAuth 范围：
https://www.googleapis.com/auth/gmail/modify
创建 OAuth 2.0 凭据：
选择“桌面应用程序”作为应用程序类型
下载 JSON 凭证文件
保存凭证文件并记下其绝对路径（将用于
--creds-file-path）
配置
对于开发/未发布的服务器
将其添加到您的 MCP 客户端配置中：
"mcpServers": {
"gmail-plugin": {
"command": "uv",
"args": [
"--directory",
"[absolute path to working directory]",
"run",
"server.py"
"--creds-file-path",
"[absolute-path-to-credentials-file]",
"--token-path",
"[absolute-path-to-access-tokens-file]"
]
}
}对于已发布的服务器
"mcpServers": {
"gmail-plugin": {
"command": "uvx",
"args": [
"gmail-plugin"
]
}
}🛠️ 开发
构建和发布
同步依赖项：
uv sync构建包：
uv build发布到 PyPI：
uv publish调试
使用MCP Inspector进行调试：
npx @modelcontextprotocol/inspector uv --directory C:\Users\sanch\Desktop\gmail_plugin\gmail-plugin run gmail-plugin📚 API 参考
可用工具
工具名称 | 描述 | 必需参数 |
| 发送电子邮件 | 收件人 ID、主题、消息 |
| 检索未读电子邮件 | 没有任何 |
| 阅读电子邮件内容 | 电子邮件ID |
| 将电子邮件移至垃圾箱 | 电子邮件ID |
| 将电子邮件标记为已读 | 电子邮件ID |
| 在浏览器中打开电子邮件 | 电子邮件ID |
可用提示
提示名称 | 描述 | 参数 |
| 担任电子邮件管理员 | 没有任何 |
| 起草新电子邮件 | 内容、收件人、收件人电子邮件 |
| 编辑现有电子邮件草稿 | 变更，current_draft |
🤝 贡献
欢迎贡献代码！欢迎提交 Pull 请求。
📄 许可证
该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。