AI导哈

Gmail MCP服务器部署工具

Gmail MCP服务器是一个高性能工具，允许AI模型如ChatGPT和Claude安全地执行收件箱任务，实现自然语言邮件起草、搜索和批量发送功能。

  • by jigs1188
  • TypeScript
  • 云端部署
  • 更新于
在 GitHub 查看 jigs1188/GmailMcp

使用说明

在铁路上部署和托管Gmail MCP服务器

Gmail MCP服务器是一个高性能实用程序，允许ChatGPT和Claude等AI模型安全地执行收件箱中的任务。它实现了模型上下文协议，支持自然语言电子邮件起草、搜索和批量发送，有效地将您的人工智能助手变成了一个完全集成的个人秘书。

关于托管Gmail MCP服务器

在Railway上部署Gmail MCP服务器可以将您的自动化工具从本地脚本转换为永久的基于云的服务。通过使用服务器发送事件（SSE）传输协议，您的服务器可以持续对外部AI平台可用，而不需要您的本地机器保持通电。设置过程涉及在Railway的环境设置中配置您的Google Cloud OAuth 2.0凭据。一旦部署，Railway将管理服务器生命周期，处理SSL加密，并提供一个稳定的URL，您可以将其插入ChatGPT Plus或Claude Desktop App，以实现即时、全天候的电子邮件自动化。

常见用例

  • AI高管出席： 让ChatGPT“查看我过去4小时的未读电子邮件，并起草优先级的简短摘要。”
  • 无缝跟进： 告诉克劳德“找到有关营销项目的电子邮件链，并礼貌地向每个人发送跟进，询问他们的状态更新。”
  • 收件箱掌握： 使用对话式查询搜索数千封电子邮件，例如“我去年去伦敦旅行预订的酒店叫什么名字？”

Gmail MCP服务器托管的依赖关系

  • 谷歌云平台项目： 需要启用Gmail API并生成OAuth 2.0客户端ID和客户端机密安全密钥。
  • 持久OAuth刷新令牌： 服务器需要保持与您的Gmail帐户的长期授权连接，而无需手动重新身份验证。

部署依赖关系

实现细节

此服务器是使用 @modelcontextprotocol/sdk 和 googleapis 图书馆。它使用a SSEServerTransport 与AI客户端保持可靠连接，允许通过标准HTTP实时执行工具。

为什么在铁路上部署Gmail MCP服务器？

Railway是一个部署基础设施堆栈的单一平台。铁路将托管您的基础设施，这样您就不必处理配置，同时允许您垂直和水平扩展它。

通过在Railway上部署Gmail MCP服务器，您离以最小的负担支持完整的全栈应用程序又近了一步。在Railway上托管您的服务器、数据库、AI代理等。 |---------|-------------| | 📨 发送邮件 |通过自然对话发送任何电子邮件| | ✍️ AI作曲 |描述你想要什么，AI写电子邮件| | 👥 批量发送 |发送给多个具有个性化的收件人| | 📋 CC/BCC |为CC和BCC收件人提供全面支持| | 🛡️ 速率限制 |保护您的Gmail不被标记（20/小时，50/天）| | 🔒 安全 |您的凭据在Apify上保持加密|

🚀 快速入门（5分钟）

步骤1:获取Gmail API凭据

  1. 首选 谷歌云控制台
  2. 创建新项目（或选择现有项目）
  3. 搜索 “Gmail API” 和 启用 它
  4. 首选 API和服务→ 凭证
  5. 点击 创建凭据→ OAuth 2.0客户端ID
  6. 选择 Web应用程序
  7. 添加此重定向URI： https://developers.google.com/oauthplayground
  8. 复制您的 客户端ID 和 客户端密钥

步骤2：获取刷新令牌

  1. 首选 OAuth游乐场
  2. 点击⚙️ （设置）→ 勾选“使用您自己的OAuth凭据”
  3. 输入您的客户端ID和客户端密码
  4. 在左侧面板中，找到 Gmail API v1 并选择：
    • https://www.googleapis.com/auth/gmail.send
    • https://www.googleapis.com/auth/gmail.readonly
  5. 点击 授权API → 使用您的Gmail登录
  6. 点击 兑换授权码以获取令牌
  7. 复制 刷新令牌

步骤3：配置此Actor

在输入框中输入您的凭据：

  • Gmail客户端ID：您的OAuth客户端ID
  • Gmail客户端密码：您的OAuth客户端密码
  • Gmail刷新令牌：步骤2中的令牌
  • Gmail电子邮件地址：您的Gmail地址

步骤4：连接到您的AI助手

对于ChatGPT：

  1. 前往设置→ Beta功能→ 启用MCP
  2. 添加MCP服务器URL: https://mcp.apify.com/?actors=YOUR_USERNAME/gmail-mcp-server

对于Claude Desktop：

添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "gmail": {
      "url": "https://mcp.apify.com/?actors=YOUR_USERNAME/gmail-mcp-server"
    }
  }
}

对于光标：

  1. 设置→ MCP服务器→ 添加服务器
  2. 输入Apify MCP URL

💬 示例命令

连接后，只需与您的AI自然对话：

你说 发生了什么
“发送电子邮件至boss@company.com说我今天病了” 发送病假电子邮件
“写一封专业的跟进电子邮件给hr@company.com关于我的工作申请” AI写入和发送
“向这5个人发送有关明天会议的电子邮件：[电子邮件]” 批量发送会议提醒
“我今天可以发送多少封电子邮件？” 显示速率限制状态

🔧 可用工具

工具 它做什么
send_email 向一个或多个收件人发送电子邮件
compose_and_send 描述意图，人工智能写作和发送
send_bulk_emails 给多个人发同一封电子邮件
check_email_status 查看剩余费率限制
verify_connection 测试Gmail连接

⚠️ 费率限制（保护您的Gmail）

限制 默认值 为什么
每小时 20封电子邮件 防止垃圾邮件标记
每天发送50封电子邮件，确保账户安全
延迟 发送之间间隔3-8秒 对Gmail来说很自然

您可以在输入设置中调整这些设置，但我们建议将其保持在较低水平以保护您的Gmail帐户。

🔒 安全与隐私

  • ✅ 您的凭据是 加密的 并安全地存储在Apify上
  • ✅ 电子邮件发送自 你自己的Gmail 账户
  • ✅ 我们 从不 阅读您的电子邮件或存储电子邮件内容
  • ✅ 您可以随时撤销访问权限 Google帐号设置

❓ 故障排除

“Gmail连接失败”

  • 确保Gmail API已在谷歌云控制台中启用
  • 检查您的刷新令牌是否正确
  • 验证您的OAuth凭据是否具有正确的重定向URI

“超出费率限制”

  • 等待小时限制重置（每小时重置一次）
  • 或者等到明天再重置每日限额

“权限不足”

  • 与双方重新授权 gmail.send 和 gmail.readonly 范围
  • 从OAuth Playground获取新的刷新令牌

📞 支持

需要帮助？

📄 许可证

MIT许可证-可免费用于个人和商业目的。

由...制作❤️ 面向人工智能自动化社区

相关 MCP