gmail

@striderlabs/mcp-gmail

为 AI Agent 提供通过 Gmail 发送、读取和搜索电子邮件能力的 MCP 服务。

面向 Agent

Agent 使用此连接器代表用户自主处理电子邮件，包括阅读重要邮件、搜索信息、撰写周到的回复以及发送邮件。

Agent 工作流示例：

1. 整理邮件： Agent 阅读新邮件、总结重要邮件，并标记需要用户关注的紧急事项
2. 回答常见问题： Agent 搜索电子邮件历史记录以查找信息，并结合过往对话内容撰写回复
3. 代为发送： Agent 根据用户意图起草并发送专业邮件（“告诉团队我会迟到”），然后将副本记录到对话中

使用示例：

用户：“有人回复我关于第二季度预算提案的邮件了吗？”

Agent：

1. gmail_search → "to:me subject:budget"
2. gmail_read → 阅读每封邮件
3. 返回摘要：“Sarah 周一回复说可以。Mark 要求修改。Finance 还没有回复。”

随后，Agent 可能会自动起草一封邮件跟进 Finance，并在发送前征求批准。

安装

npx @striderlabs/mcp-gmail

配置

添加到 MCP 客户端配置中（例如 Claude Desktop）：

{
  "mcpServers": {
    "strider-gmail": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-gmail"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

可用工具

gmail_send

从用户的 Gmail 账户发送电子邮件。

参数：

• to（必填）：收件人电子邮件地址
• subject（必填）：电子邮件主题
• body（必填）：电子邮件正文内容
• cc（可选）：抄送收件人
• bcc（可选）：密送收件人

gmail_search

使用 Gmail 搜索语法搜索电子邮件。

参数：

• query（必填）：Gmail 搜索查询（例如，“from:[email protected]”）
• maxResults（可选）：最大结果数（默认值：10）

gmail_read

读取特定电子邮件的完整内容。

参数：

• messageId（必填）：Gmail 邮件 ID

gmail_list

列出收件箱中的近期邮件。

参数：

• maxResults（可选）：最多列出的邮件数（默认值：10）
• label（可选）：按标签筛选（例如，“INBOX”、“UNREAD”）

获取 Google OAuth 凭据

1. 前往 Google Cloud Console
2. 创建新项目或选择现有项目
3. 启用 Gmail API
4. 创建 OAuth 2.0 凭据
5. 使用 OAuth playground 或你的应用获取刷新令牌

响应格式

所有工具均返回结构化 JSON：

{
  "success": true,
  "messageId": "...",
  "message": "Email sent successfully"
}

Strider Labs 旗下项目

Strider Labs 为 AI Agent 构建操作执行基础设施。

• 网站：https://striderlabs.ai
• GitHub：https://github.com/striderlabs

许可证

MIT