什么是MCP Gmail?

MCP Gmail 是一个基于Google Apps Script构建的MCP服务器，允许您通过Claude Desktop等客户端与您的Gmail账户进行交互。您可以轻松地搜索邮件、获取邮件详情以及下载附件。

如何使用MCP Gmail?

首先部署Google Apps Script，然后在Claude Desktop中配置服务器地址和API密钥。完成设置后，即可开始使用相关功能。

适用场景

适用于需要快速访问Gmail邮件内容的专业人士，例如处理工作邮件、管理日程安排等。

主要功能

搜索邮件支持使用Gmail搜索语法查找邮件，例如按主题、时间范围筛选。

获取邮件详情获取指定邮件的详细信息，包括发件人、收件人、正文等内容。

下载附件从指定邮件中下载附件文件。

优势与局限性

优势

无需安装额外软件即可操作Gmail

支持多种搜索条件，提高工作效率

安全可靠，仅授权用户可访问

局限性

依赖Google Apps Script环境运行

部分高级功能可能受权限限制

如何使用

部署Google Apps Script

访问Google Apps Script平台，创建新项目并将提供的代码复制粘贴到编辑器中。点击部署按钮，选择执行者为‘我’，访问权限设置为‘任何人’。

生成API密钥

在Google Apps Script部署完成后，生成随机的API密钥用于身份验证。

配置Claude Desktop

打开Claude Desktop配置文件，添加MCP Gmail工具的相关信息。

使用案例

搜索最近一天的主题为“会议”的邮件用户希望查找昨天收到的所有关于“会议”的邮件。

获取特定邮件的完整内容用户需要查看某封邮件的具体内容，包括发件人、收件人和正文。

常见问题

如何确保我的API密钥安全？

为什么无法找到某些邮件？

是否支持多账户登录？

🚀 MCP Gmail 服务器端

此模型上下文协议 (MCP) 服务器用于 Gmail 集成，允许 Claude 桌面版（或其他 MCP 客户端）通过 Google Apps 脚本与您的 Gmail 帐户交互，实现自动化邮件处理任务。

🚀 快速开始

快速上手（用户）

先决条件

Node.js 18+（可通过 brew install node 进行安装）
拥有一个 Gmail 帐户
完成 Google Apps 脚本部署
安装 Claude 桌面版（可从 Claude 桌面版官网下载安装）

配置

部署 Google Apps 脚本
- 访问 Google Apps Script 创建一个新项目。
- 复制 code.gs 文件中的所有内容，并粘贴到脚本编辑器中。
- 点击 “部署” > “新建部署”。
- 选择 “网络应用” 作为部署类型。
- 进行以下配置设置：
  - 执行身份：我
  - 访问权限：任何人
- 点击 “部署”。
- 当出现提示时，审查并授权脚本访问您的 Gmail 帐户。
- 复制部署 URL，并生成一个随机的 API 密钥以确保安全。
⚠️ 重要提示

脚本需要 Gmail 访问权限。首次部署和运行脚本时，Google 会要求您审查并授予这些权限。请按以下步骤操作：
1. 点击 “审查权限”。
2. 选择您的 Google 帐户。
3. 如果出现警告，点击 “高级”。
4. 点击 “前往 [您的项目名称] (不安全)”。
5. 点击 “允许” 授予必要的 Gmail 权限。
打开 Claude 桌面版配置文件 配置文件路径为：~/Library/Application Support/Claude/claude_desktop_config.json。

您可以通过以下步骤找到此文件：
1. 打开 Claude 桌面版。
2. 点击菜单栏中的 “Claude”。
3. 选择 “设置”。
4. 点击 “开发者”。
在配置文件中添加以下内容

{
  "tools": {
    "gmail": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-gmail-gas"],
      "env": {
        "GAS_ENDPOINT": "YOUR_DEPLOYMENT_URL",
        "VALID_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

⚠️ 重要提示

请将 YOUR_DEPLOYMENT_URL 和 YOUR_API_KEY 替换为您实际的值。

开发者指南

先决条件

Node.js 18+（可通过 brew install node 进行安装）
拥有一个 Gmail 帐户
具备 Google Apps 脚本相关知识
安装 Claude 桌面版（可从 Claude 桌面版官网下载安装）
安装 tsx（可通过 npm install -g tsx 进行安装）

安装

git clone https://github.com/kazuph/mcp-gmail-gas.git
cd mcp-gmail-gas
npm install
npm run build

开发配置

确保 Claude 桌面版已安装并处于运行状态。
如果尚未安装，可全局安装 tsx：

npm install -g tsx
# 或者
pnpm add -g tsx

修改您的 Claude 桌面版配置文件，文件路径为：~/Library/Application Support/Claude/claude_desktop_config.json。在 MCP 客户端的配置中添加以下内容：

{
  "tools": {
    "gmail": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-gmail-gas"],
      "env": {
        "GAS_ENDPOINT": "YOUR_DEPLOYMENT_URL",
        "VALID_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}