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

A

license - permissive license

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Gmail Plugin MCP Server