Gmail 插件 MCP 服务器

Python 版本

强大的 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 凭据：
- 前往Google Cloud Console
- 创建新项目或选择现有项目
- 启用 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 参考

可用工具

工具名称	描述	必需参数
`send-email`	发送电子邮件	收件人 ID、主题、消息
`get-unread-emails`	检索未读电子邮件	没有任何
`read-email`	阅读电子邮件内容	电子邮件ID
`trash-email`	将电子邮件移至垃圾箱	电子邮件ID
`mark-email-as-read`	将电子邮件标记为已读	电子邮件ID
`open-email`	在浏览器中打开电子邮件	电子邮件ID

可用提示

提示名称	描述	参数
`manage-email`	担任电子邮件管理员	没有任何
`draft-email`	起草新电子邮件	内容、收件人、收件人电子邮件
`edit-draft`	编辑现有电子邮件草稿	变更，current_draft

🤝 贡献

欢迎贡献代码！欢迎提交 Pull 请求。

📄 许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Gmail Plugin MCP Server