mcp-gsuite MCP server

基本能力

产品定位

mcp-gsuite 是一个用于与 Google 产品（如 Gmail 和 Calendar）交互的 MCP 服务器，旨在提供高效的邮件和日程管理功能。

核心功能

1. Gmail 功能
2. 获取 Gmail 用户信息
3. 灵活搜索电子邮件（如未读邮件、特定发件人、日期范围、带附件等）
4. 通过 ID 检索完整的电子邮件内容
5. 创建新的草稿邮件（包括收件人、主题、正文和抄送选项）
6. 删除草稿邮件
7. 回复现有邮件（可立即发送或保存为草稿）
8. 通过 ID 批量检索电子邮件

9. 将电子邮件中的多个附件保存到本地系统

10. Calendar 功能

11. 管理多个日历
12. 获取指定时间范围内的日历事件
13. 创建日历事件（包括标题、开始/结束时间、可选位置和描述、可选参与者、自定义时区支持和通知偏好）

14. 删除日历事件

15. 通用功能

16. 支持多个 Google 账户

适用场景

• 自动化邮件处理（如自动回复、邮件分类）
• 日程管理（如会议安排、事件提醒）
• 个人生产力工具（如邮件摘要、日程查询）

工具列表

• Gmail 工具：用于查询、创建、删除和回复邮件。
• Calendar 工具：用于查询、创建和删除日历事件。

常见问题解答

1. 如何设置 OAuth2 授权？

2. 需要在 Google Cloud Console 中创建 OAuth2 凭据，并启用 Gmail API 和 Google Calendar API。

3. 如何管理多个 Google 账户？

4. 通过 .accounts.json 文件配置多个账户信息。

5. 如何调试服务器？

6. 推荐使用 MCP Inspector 进行调试。

使用教程

使用依赖

1. OAuth2 设置
2. 在 Google Cloud Console 中创建 OAuth2 凭据。
3. 启用 Gmail API 和 Google Calendar API。

4. 配置 OAuth 同意屏幕。

5. 配置文件

6. 创建 .gauth.json 文件，包含客户端 ID 和密钥。
7. 创建 .accounts.json 文件，包含账户信息。

安装教程

1. 通过 Smithery 安装

npx -y @smithery/cli install mcp-gsuite --client claude

1. 手动配置

{
  "mcpServers": {
    "mcp-gsuite": {
      "command": "uv",
      "args": [
        "--directory",
        "<dir_to>/mcp-gsuite",
        "run",
        "mcp-gsuite"
      ]
    }
  }
}

调试方式

1. 使用 MCP Inspector 调试

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-gsuite run mcp-gsuite

1. 查看服务器日志

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-gsuite.log

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。