JinDaGe - mcp-gmail MCP Details

article

README

🚀 MCP Gmail 服务器

MCP Gmail 服务器是一个基于 Model Context Protocol (MCP) 的服务器，它借助 MCP Python SDK 实现了对 Gmail 的便捷访问。通过该服务器，用户能够以 MCP 资源的形式操作 Gmail 邮件，还能使用一系列工具来创建、发送、搜索邮件等。

✨ 主要特性

资源暴露：将 Gmail 消息作为 MCP 资源暴露，方便用户统一管理和操作。
邮件工具丰富：提供了 compose_email、send_email、search_emails 等多种工具，涵盖了邮件的创建、发送、搜索等常见操作。
标签管理：支持对邮件标签的操作，如 list_available_labels、add_label_to_message、remove_label_from_message 等。

📦 安装指南

第一步：安装依赖项

使用 uv 命令同步项目并安装所有必要的依赖项：

uv sync

第二步：配置 OAuth 凭证

打开 Google Cloud Console 并创建一个新的项目。
启用 Gmail API。
进入 OAuth 界面设置部分，填写应用信息和权限范围。
创建 OAuth 客户端 ID 并下载 credentials.json 文件。

第三步：验证配置

运行以下命令以确保配置正确：

python test_script.py

🚀 快速开始

启动服务器

开发模式：在开发模式下启动服务器，使用以下命令：

uv run server.py

安装到 Claude Desktop：配置 command 属性为正确的 uv 可执行文件路径，并设置环境变量指向 credentials.json 和 token.json 文件。

环境变量配置

项目可以通过以下环境变量进行配置： | 属性 | 详情 | |------|------| | MCP_GMAIL_CREDENTIALS_PATH | 指定 OAuth 凭证 JSON 文件的路径（默认值：credentials.json） | | MCP_GMAIL_TOKEN_PATH | 指定存储 OAuth 令牌文件的路径（默认值：token.json） | | MCP_GAIL_MAX_RESULTS | 默认搜索查询结果的最大数量（默认值：10） |

💻 使用示例

可用资源

gmail://messages/{message_id}: 访问单个邮件消息
gmail://threads/{thread_id}: 访问邮件主题

可用工具

compose_email: 创建新邮件草稿
send_email: 发送邮件
search_emails: 根据发件人、收件人或主题搜索邮件
query_emails: 使用原始 Gmail 查询语法搜索邮件
get_emails: 按 ID 获取多个邮件消息
list_available_labels: 获取所有可用的 Gmail 标签
mark_message_read: 标记消息为已读
add_label_to_message: 向消息添加标签
remove_label_from_message: 从消息移除标签

📄 许可证

本项目采用 MIT 许可证。

mcp-gmail