# Gmail MCP服务器

一个功能强大、特性丰富的Gmail模型上下文协议（MCP）服务器。通过完整的Gmail API集成，使Claude和Cursor等AI助手能够使用自然语言搜索、阅读、发送、组织和管理电子邮件。

Canonical URL: https://a2a-mcp.org/entry/gmail-mcp-zh

Language: zh

Category: MCP Servers

Updated: 2026-04-01

## 概述

**Gmail MCP 服务器** 是一个社区开发的模型上下文协议（MCP）服务器，它将 Gmail 与 AI 编程及生产力助手集成起来。它允许像 Claude Desktop、Cursor 以及其他兼容 MCP 的客户端通过自然语言命令直接与您的 Gmail 账户交互。

存在多种实现版本，其中 `theposch/gmail-mcp` 是最功能丰富的基于 Python 的版本之一。其他流行的分支版本在身份验证方式（OAuth、IMAP/SMTP、AutoAuth 或 headless）、工具数量以及附加功能（如样式分析或批量操作）上有所不同。

## 主要功能

.

- **邮件操作**：搜索收件箱/会话、读取消息、列出最近邮件，以及获取包含附件的完整内容。
- **发送与草稿**：撰写和发送新邮件或回复、创建草稿，并维护会话线程。
- **组织工具**：管理标签、应用过滤器、归档、删除，或标记为已读/未读。
- **高级功能**：分析邮件写作风格、执行批量操作、导出到 CSV，以及处理多账户设置。
- **安全认证**：支持 Google OAuth2（推荐）、通过 IMAP/SMTP 的应用密码，或自动认证方法。
- **LLM友好响应**：提供结构化、节省 token 的输出，并包含上下文感知的摘要。
(智能收件箱管理)："总结我工作相关的未读邮件并标记紧急的。"

- **客户端兼容性**：适用于 Claude Desktop、Cursor、VS Code 扩展、Gemini CLI 以及任何符合 MCP 标准的工具。

## 使用场景

- **智能收件箱管理**："总结我工作相关的未读邮件并标记紧急的。"
- **自动回复**："用专业的跟进内容回复客户 X 的最新会话。"
- **邮件分类与效率提升**："找出上周所有关于项目 Y 的邮件并起草一份状态更新。"
-Hosted & Protected: Analyze your past emails and generate replies that match your tone. *创作风格匹配*：分析您过去的邮件并生成符合您语调的回复。

## 安装与设置（通用方法）

大多数实现版本遵循类似的步骤：

1.  **Google API 设置**（针对 OAuth 版本）：在 Google Cloud Console 中创建一个项目，启用 Gmail API，并配置 OAuth 同意屏幕和凭证（桌面应用类型）。
2.  **克隆与安装**：
    ```bash
    git clone https://github.com/theposch/gmail-mcp.git
    cd gmail-mcp
    pip install -r requirements.txt
    ```
3.  **配置凭证**：设置 `credentials.json` 或环境变量来存放您的 OAuth 令牌。
4.  **运行服务器**，并将其添加到您的 MCP 客户端（Claude Desktop 配置、Cursor 设置等）。

一些变体版本提供了更简单的单文件设置、Docker 镜像或 Chrome 扩展桥接，以避免完整的 API 密钥设置。

**注意**：授予邮件访问权限需要谨慎，因此请务必查看具体仓库 README 文件中的最新认证和安全建议。

## 热门实现方案

- **theposch/gmail-mcp**：功能丰富的 Python 版本。
- **PaulFidika/gmail-mcp-server**：轻量级单文件方案，专注于邮件搜索、风格分析和草稿撰写。
- **jeremyjordan/mcp-gmail**：基于官方 MCP Python SDK 的简洁实现。
- **GongRzhe/Gmail-MCP-Server**（AutoAuth）：提供简化的身份验证流程（已归档但仍有影响力）。
- 基于 IMAP/SMTP 或无头浏览器方案，适用于不同安全偏好的用户。

许多用户将 Gmail MCP 与 Google Calendar MCP 结合使用，实现统一的生产力管理。

## 兼容性与安全性

- **客户端支持**：Claude Desktop/Code、Cursor 及大多数 MCP 工具。
- **身份验证方式**：OAuth2（最安全/推荐）、使用应用密码的 IMAP 协议，或自定义方法。
- **许可证**：通常采用 MIT 或类似协议（请查阅具体代码仓库说明）。

Gmail MCP 服务器通过将您的邮箱转变为对话式交互界面，显著提升了人工智能的工作效率。但使用前请务必遵循最小权限原则分配接口范围，并在授予访问权限前仔细审查代码。

## Tags

- gmail
- mcp
- 电子邮件
- 人工智能集成
- claude
- cursor
- 自动化
- google-api
- 生产力

## Sources

- [Project website](https://github.com/theposch/gmail-mcp)