Gmail 插件 MCP 服务器

强大的 MCP 服务器，支持 Gmail 集成，让您可以直接通过 MCP 客户端管理邮件。此插件可无缝访问 Gmail 的核心功能，包括阅读、发送和管理邮件。

参考：有关使用 uvx 的示例 MCP 服务器实现，请查看此示例。

🎥 演示

https://github.com/user-attachments/assets/df9e86cf-1f6b-4265-9c68-b3ed88103d1f

✨ 特点

📧 发送和接收电子邮件
📥 阅读未读消息
🗑️ 垃圾邮件
📱 在浏览器中打开电子邮件
📝 将电子邮件标记为已读
🔒 安全的 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文件。

Gmail Plugin MCP Server

Integrations

Gmail 插件 MCP 服务器

🎥 演示

✨ 特点

🚀 快速入门

先决条件

安装

配置

对于开发/未发布的服务器

对于已发布的服务器

🛠️ 开发

构建和发布

调试

📚 API 参考

可用工具

可用提示

🤝 贡献

📄 许可证