AI导哈

Gmail集成服务

MCP Gmail是一个通过Google Apps Script实现Claude Desktop（或任何MCP客户端）与Gmail账户交互的服务，提供邮件搜索、获取邮件内容和下载附件等功能。

  • by kazuph
  • JavaScript
  • 本地部署
  • 12 星标
  • 更新于
在 GitHub 查看 kazuph/mcp-gmail-gas

使用说明

MCP Gmail

用于Gmail集成的模型上下文协议服务器。这允许Claude Desktop（或任何MCP客户端）通过Google Apps Script与您的Gmail帐户进行交互。

快速入门（适用于用户）

先决条件

  • Node.js 18+（通过安装 brew install node)
  • Gmail帐户
  • Google Apps脚本部署
  • Claude桌面（从安装https://claude.ai/desktop)

配置

  1. 部署Google Apps脚本
  • 访问 谷歌应用脚本 并创建一个新项目
  • 复制以下内容的全部内容 code.gs 并将其粘贴到脚本编辑器中
  • 点击“部署”>“新部署”
  • 选择“Web应用程序”作为部署类型
  • 配置以下设置：
    • 执行方式：我
    • 谁有权访问：任何人
    • 点击“部署”
  • 出现提示时，查看并授权应用程序访问您的Gmail帐户
  • 复制部署URL并生成随机API密钥以确保安全

注意：该脚本需要Gmail访问权限。当你第一次部署和运行脚本时，谷歌会要求你审查并授予这些权限。确保：

  1. 点击“查看权限”

  2. 选择您的Google帐户

  3. 如果看到警告，请单击“高级”

  4. 单击“转到[您的项目名称]（不安全）”

  5. 点击“允许”以授予必要的Gmail权限

  6. 在以下位置打开您的Claude Desktop配置文件： ~/Library/Application Support/Claude/claude_desktop_config.json

您可以通过Claude Desktop菜单找到：

  1. 打开克劳德桌面

  2. 点击Mac菜单栏上的Claude

  3. 点击“设置”

  4. 点击“开发者”

  5. 将以下内容添加到您的配置中：

{
  "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帐户
  • 谷歌应用脚本
  • Claude桌面（从安装https://claude.ai/desktop)
  • 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 Desktop已安装并正在运行。

  2. 如果您还没有全局安装tsx：

npm install -g tsx
# or
pnpm add -g tsx
  1. 修改位于以下位置的Claude Desktop配置： ~/Library/Application Support/Claude/claude_desktop_config.json

将以下内容添加到MCP客户端的配置中：

{
  "tools": {
    "gmail": {
      "args": ["tsx", "/path/to/mcp-gmail-gas/index.ts"],
      "env": {
        "GAS_ENDPOINT": "YOUR_DEPLOYMENT_URL",
        "VALID_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

可用工具

  • gmail_search_messages：使用Gmail搜索查询语法搜索电子邮件（例如，“主题：Meeting newer_than:1d”）
  • gmail_get_message：获取特定电子邮件的完整内容和详细信息
  • gmail_download_attachment：从特定电子邮件下载附件

安全说明

始终保持你的 VALID_API_KEY 机密，永远不要将其提交给版本控制。此密钥有助于确保只有授权的客户端才能通过Google Apps脚本部署访问您的Gmail。

相关 MCP