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. 点击“查看权限”

1. 选择您的Google帐户

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

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

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

1. 在以下位置打开您的Claude Desktop配置文件：

~/Library/Application Support/Claude/claude_desktop_config.json

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

1. 打开克劳德桌面

1. 点击Mac菜单栏上的Claude

1. 点击“设置”

1. 点击“开发者”

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

{
  "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已安装并正在运行。

1. 如果您还没有全局安装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。