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://gips0.baidu.com/it/u=2121693763,772060568&fm=3081&app=3081&f=PNG?w=760&h=400" 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
# 或
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。