MCP Gmail

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

<a href="https://glama.ai/mcp/servers/7awla69pjq"><img width="380" height="200" src="https://glama.ai/mcp/servers/7awla69pjq/badge" alt="@kazuph/mcp-gmail-gas MCP server" /></a>

快速开始（面向用户）

前提条件

• Node.js 18+（通过 brew install node 安装）
• Gmail 帐户
• Google Apps Script 部署
• Claude Desktop (从 https://claude.ai/desktop 安装)

配置

1. 部署 Google Apps Script

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

注意：该脚本需要 Gmail 访问权限。首次部署和运行脚本时，Google 会要求您审查并授予这些权限。请务必：

1. 点击“审查权限”

2. 选择您的 Google 帐户

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

4. 点击“转到 [您的项目名称] (不安全)”

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

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

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

1. 打开 Claude Desktop

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 帐户
• Google Apps Script
• Claude Desktop (从 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

3. 修改您的 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 搜索查询语法搜索电子邮件（例如，“subject:Meeting newer_than:1d”）
• gmail_get_message: 获取特定电子邮件的完整内容和详细信息
• gmail_download_attachment: 从特定电子邮件下载附件

安全提示

始终对您的 VALID_API_KEY 保密，切勿将其提交到版本控制。此密钥有助于确保只有授权客户端才能通过 Google Apps Script 部署访问您的 Gmail。