@kazuph/mcp-gmail-gas

🚀 MCP Gmail 服务器端

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

🚀 快速开始

快速上手（用户）

先决条件

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

配置

1. 部署 Google Apps 脚本

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

   ⚠️ 重要提示

   脚本需要 Gmail 访问权限。首次部署和运行脚本时，Google 会要求您审查并授予这些权限。请按以下步骤操作：

   1. 点击 “审查权限”。
   2. 选择您的 Google 帐户。
   3. 如果出现警告，点击 “高级”。
   4. 点击 “前往 [您的项目名称] (不安全)”。
   5. 点击 “允许” 授予必要的 Gmail 权限。

2. 打开 Claude 桌面版配置文件 配置文件路径为：~/Library/Application Support/Claude/claude_desktop_config.json。

   您可以通过以下步骤找到此文件：

   1. 打开 Claude 桌面版。
   2. 点击菜单栏中的 “Claude”。
   3. 选择 “设置”。
   4. 点击 “开发者”。

3. 在配置文件中添加以下内容

{
  "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

开发配置

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

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

3. 修改您的 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"
      }
    }
  }
}

⚠️ 重要提示

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

可用工具

项目提供了以下实用功能：

1. 搜索邮件
2. 获取特定邮件内容
3. 下载附件

注意事项

⚠️ 重要提示

• 安全第一：请确保 API 密钥的保密性，避免因泄露导致安全风险。
• 权限管理：合理设置 Google Apps 脚本的权限，防止未经授权的访问。

通过此项目，您可以方便地将 Claude 桌面版与 Gmail 集成，实现自动化邮件处理任务。