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文件。

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

支持 Gmail 集成的 MCP 服务器，允许用户直接通过 Claude Desktop 等 MCP 客户端管理电子邮件（发送、接收、阅读、删除、标记为已读）。

Related MCP Servers

@kazuph/mcp-gmail-gas
kazuph
A
security
A
license
A
quality
Model Context Protocol server for Gmail integration. This allows Claude Desktop (or any MCP client) to interact with your Gmail account through Google Apps Script.
Last updated -
3
7
8
JavaScript
MIT License
Gmail MCP Server
jmonsellier
-
security
A
license
-
quality
Integrates with Gmail to enable sending, reading, drafting, and managing emails via the Model Context Protocol (MCP), allowing users to interact with email tasks through automated client prompts.
Last updated -
Python
GPL 3.0
Systemprompt MCP Gmail Server
Ejb503
-
security
F
license
-
quality
Enables users to manage Gmail accounts using AI agent-assisted operations via an MCP protocol, supporting email search, reading, deletion, and sending with a voice-powered interface.
Last updated -
2
5
TypeScript
Email Sending MCP
resend
A
security
F
license
A
quality
A simple MCP server that enables users to send emails using Resend's API, integrating with tools like Cursor and Claude Desktop for seamless email composition and delivery.
Last updated -
1
6
321
TypeScript

View all related MCP servers

Gmail Plugin MCP Server