MCP Gmail

用于Gmail集成的Model Context Protocol服务器。这允许Claude Desktop（或任何MCP客户端）通过Google Apps Script与您的Gmail账户进行交互。

快速开始（用户）

前提条件

• 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 文件中的全部内容并粘贴到脚本编辑器中
• 点击 "Deploy" > "New deployment"
• 选择 "Web app" 作为部署类型
• 配置以下设置：
  • 执行者: 我自己
  • 谁可以访问: 任何人
  • 点击 "Deploy"
• 当提示时，审查并授权应用程序访问您的Gmail账户
• 复制部署URL并生成随机API密钥以确保安全

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

1. 点击 "Review Permissions"

2. 选择您的Google账户

3. 如果看到警告，请点击 "Advanced"

4. 点击 "Go to [Your Project Name] (unsafe)"

5. 点击 "Allow" 以授予必要的Gmail权限

6. 打开您的Claude Desktop配置文件:
   ~/Library/Application Support/Claude/claude_desktop_config.json

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

1. 打开Claude Desktop

2. 在Mac菜单栏上点击Claude

3. 点击 "Settings"

4. 点击 "Developer"

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

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

安全注意事项

始终保密您的 VALID_API_KEY 并且不要将其提交到版本控制系统中。这个密钥有助于确保只有经过授权的客户端才能通过Google Apps Script部署访问您的Gmail。