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 账户

适用场景

• 管理个人或工作电子邮件
• 安排和跟踪日历事件
• 批量处理电子邮件和附件
• 自动化回复和草稿管理

工具列表

1. Gmail 工具
2. 提供电子邮件搜索、检索、创建和删除功能

3. 支持附件管理和批量操作

4. Calendar 工具

5. 提供日历事件管理功能，包括创建、检索和删除
6. 支持多日历管理和时间范围查询

常见问题解答

1. OAuth2 授权问题
2. 确保在 Google Cloud Console 中正确配置了 OAuth2 凭据和授权范围

3. 检查 .gauth.json 和 .accounts.json 文件的路径和内容是否正确

4. 多账户管理

5. 在 .accounts.json 中配置多个账户信息，并确保每个账户都有相应的 OAuth2 授权

6. 调试问题

7. 使用 MCP Inspector 进行调试，或查看服务器日志文件

使用教程

使用依赖

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

4. 配置授权范围和重定向 URI

5. 配置文件准备

6. 创建 .gauth.json 文件，包含 OAuth2 客户端配置
7. 创建 .accounts.json 文件，包含账户信息

安装教程

1. 通过 Smithery 安装 bash npx -y @smithery/cli install @alBERT-launcher/mcp-gsuite --client claude

2. 手动配置

3. 确保已安装 Claude Desktop，并配置 claude_desktop_config.json 文件

调试方式

1. 使用 MCP Inspector 调试 bash npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-gsuite run mcp-gsuite

2. 查看服务器日志 bash tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-gsuite.log

3. 命令行选项 bash uv run mcp-gsuite --gauth-file /path/to/custom/.gauth.json --accounts-file /path/to/custom/.accounts.json --credentials-dir /path/to/custom/credentials

许可证

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