Gmail MCP

Overview

Gmail MCP 是一个模型上下文协议服务器，允许 AI 代理与 Google Gmail 进行交互。通过此 MCP 服务器，AI 可以搜索邮件、读取邮件内容、发送新邮件、管理标签和联系人。这对于邮件管理、客户服务和个人助理场景非常有用。

Gmail MCP 使得 AI 代理能够成为智能邮件助手，自动分类邮件、生成回复、提取重要信息、安排跟进。它特别适合处理大量邮件、自动化回复和邮件工作流管理。

Features

• 邮件搜索：使用 Gmail 搜索语法查找邮件
• 邮件读取：获取邮件完整内容（包括 HTML 和纯文本）
• 邮件发送：发送新邮件和回复
• 标签管理：创建、应用、移除标签
• 联系人管理：获取联系人信息
• 草稿管理：创建和发送草稿
• 线程管理：获取邮件线程对话

Installation

# 使用 npx 运行
npx -y @modelcontextprotocol/server-gmail

# 或使用 uvx
uvx mcp-server-gmail

Configuration

添加以下配置到 claude_desktop_config.json：

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-gmail"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
      }
    }
  }
}

设置 Google Cloud 凭证

1. 访问 https://console.cloud.google.com/
2. 创建新项目
3. 启用 Gmail API
4. 创建 OAuth 2.0 凭证
5. 下载凭证 JSON 文件
6. 首次运行时完成 OAuth 授权流程

Available Tools

Tool	Description
gmail_search_messages	搜索 Gmail 邮件
gmail_get_message	获取邮件详情
gmail_get_thread	获取邮件线程
gmail_send_message	发送新邮件
gmail_create_draft	创建邮件草稿
gmail_modify_message	修改邮件（添加/移除标签）
gmail_list_labels	列出所有标签

Usage Examples

示例 1：搜索未读邮件

AI: 搜索所有未读邮件，并总结主要内容

Gmail MCP:
- 执行搜索: is:unread
- 获取每封邮件详情
- 总结主题和发件人

示例 2：自动回复

AI: 为以下邮件起草回复：
"Hi, could you send me the project report by Friday?"

Gmail MCP:
- 分析邮件内容
- 生成回复草稿
- 调用 gmail_create_draft
- 用户审核后发送

示例 3：邮件分类

AI: 将所有包含"invoice"或"payment"的邮件标记为"财务"

Gmail MCP:
- 搜索: invoice OR payment
- 创建"财务"标签（如果不存在）
- 应用标签到匹配邮件

Pros

• ✅ 完整的 Gmail API 覆盖
• ✅ 支持 Gmail 搜索语法
• ✅ 适合邮件自动化
• ✅ 开源免费
• ✅ 与 Google Workspace 生态集成

Cons

• ❌ 需要 Google Cloud 项目设置
• ❌ OAuth 授权流程较复杂
• ❌ 某些功能需要 Gmail API 权限审批
• ❌ Rate limit 限制

When to Use

• 需要 AI 辅助邮件管理时
• 想要自动化邮件回复时
• 需要提取邮件重要信息时
• 想要管理邮件标签和分类时

Resources

• GitHub 仓库
• Gmail API 文档