MCP Gmail
用于 Gmail 集成的模型上下文协议服务器。这允许 Claude Desktop(或任何 MCP 客户端)通过 Google Apps Script 与您的 Gmail 帐户进行交互。
快速入门(针对用户)
先决条件
Node.js 18+(通过
brew install node安装)Gmail 帐户
Google Apps 脚本部署
Claude Desktop(从https://claude.ai/desktop安装)
配置
部署 Google Apps 脚本
访问Google Apps Script并创建一个新项目
复制
code.gs的全部内容并将其粘贴到脚本编辑器中点击“部署”>“新部署”
选择“Web 应用”作为部署类型
配置以下设置:
执行身份:我
谁有访问权限:任何人
点击“部署”
出现提示时,请查看并授权该应用访问您的 Gmail 帐户
复制部署 URL 并生成随机 API 密钥以确保安全
注意:该脚本需要 Gmail 访问权限。首次部署并运行该脚本时,Google 会要求您审核并授予这些权限。请确保:
点击“审核权限”
选择您的Google帐户
如果看到警告,请点击“高级”
点击“转到[您的项目名称](不安全)”
点击“允许”授予必要的 Gmail 权限
打开您的 Claude Desktop 配置文件:
~/Library/Application Support/Claude/claude_desktop_config.json
您可以通过 Claude 桌面菜单找到它:
打开 Claude 桌面
在 Mac 菜单栏上单击 Claude
点击“设置”
点击“开发者”
将以下内容添加到您的配置中:
注意:请将YOUR_DEPLOYMENT_URL和YOUR_API_KEY替换为您的实际值。
Related MCP server: Gmail Plugin MCP Server
对于开发人员
先决条件
Node.js 18+(通过
brew install node安装)Gmail 帐户
Google Apps脚本
Claude Desktop(从https://claude.ai/desktop安装)
tsx(通过
npm install -g tsx)
安装
开发配置
确保 Claude Desktop 已安装并正在运行。
如果还没有安装 tsx,请全局安装:
修改位于以下位置的 Claude Desktop 配置:
~/Library/Application Support/Claude/claude_desktop_config.json
将以下内容添加到您的 MCP 客户端的配置中:
可用工具
gmail_search_messages:使用 Gmail 搜索查询语法搜索电子邮件(例如“subject:Meeting newer_than:1d”)gmail_get_message:获取特定电子邮件的完整内容和详细信息gmail_download_attachment:从特定电子邮件下载附件
安全说明
请始终对您的VALID_API_KEY保密,切勿将其提交到版本控制中。此密钥有助于确保只有授权的客户端才能通过 Google Apps 脚本部署访问您的 Gmail。