mcp-gsuite

用途

mcp-gsuite 是一个 MCP 服务器，用于与 Google Workspace（G Suite）产品交互。根据仓库资料，目前它支持 Gmail 和 Google Calendar 的集成，旨在让 AI 助手能够读取和处理邮件、管理日程。

主要能力

Gmail

支持多个 Google 账号。
获取当前 Gmail 用户信息。
使用灵活条件搜索邮件，例如：未读邮件、来自特定发件人、日期范围、带附件等。
通过邮件 ID 检索完整邮件内容。
创建新草稿邮件，可设置收件人、主题、正文和抄送（CC）。
删除草稿邮件。
回复已有邮件，可以选择立即发送或保存为草稿。
通过多个邮件 ID 一次性检索多封邮件。
将邮件中的多个附件保存到本地系统。

Google Calendar

管理多个日历。
获取指定时间范围内的日历事件。
创建日历事件，可设置：标题、开始/结束时间；可选地点和描述；可选参与者；自定义时区支持；通知偏好。
删除日历事件。

示例提示词

仓库提供了一些可尝试的示例提示词：

检索我最新未读消息
搜索来自 Scrum Master 的邮件
检索来自 accounting 的所有邮件
取出关于 ABC 的邮件并总结
给 Alice 的上一封邮件写一封友好的回复并上传草稿
回复 Bob 的邮件并附上感谢语，保存为草稿
我明天有什么日程？
查看我私人账户下周的家庭日程
我需要下周与 Tim 计划一个 2 小时的活动。建议一些时间段。

使用方式

通过 Smithery 安装

可通过 Smithery 为 Claude Desktop 自动安装 mcp-gsuite。

认证设置

Google Workspace（G Suite）API 需要 OAuth2 授权。需按以下步骤设置认证：

创建 OAuth2 凭据：进入 Google Cloud Console；新建项目或选择已有项目；为项目启用 Gmail API 和 Google Calendar API；进入“凭据” → “创建凭据” → “OAuth 客户端 ID”；应用类型选择“桌面应用”或“Web 应用”；配置 OAuth 同意屏幕并填写所需信息；添加授权的重定向 URI（本地开发需包含 http://localhost:4100/code）。
在工作目录创建 .gauth.json，包含客户端信息。
创建 .accounts.json，包含账号信息。可指定多个账号，并确保它们在 Google Auth 应用中拥有访问权限。extra_info 字段尤其值得关注，因为可以在这里添加希望 AI 了解的账号信息（例如是否具有特定日程）。

注意：首次对某个账号执行工具时，会打开浏览器，重定向到 Google 并询问凭据、权限范围等。成功登录后，凭据会存储在本地文件 .oauth.{email}.json 中。一旦完成授权，将使用刷新令牌。

Claude Desktop 配置文件位置

macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

也可使用 uv run mcp-gsuite --accounts-file /path/to/custom/.accounts.json 指定不同的账号文件，或用 --credentials-dir /path/to/custom/credentials 指定不同的凭据目录。

配置选项

该 MCP 服务器可通过多个命令行选项配置自定义的认证和账号信息路径：

--gauth-file：指定包含 OAuth2 客户端配置的 .gauth.json 路径，默认为 ./.gauth.json。
--accounts-file：指定包含 Google 账号信息的 .accounts.json 路径，默认为 ./.accounts.json。
--credentials-dir：指定认证成功后 OAuth 凭据存储的目录，默认为当前工作目录下每个账号的子目录，文件名为 .oauth.{email}.json。

这些选项便于管理不同环境或多组凭据与账号，尤其适用于开发和测试场景。当你运行多个采用不同配置的服务器实例，或部署到默认路径不合适的环境时，此配置尤为有用。

构建与发布

若要准备分发包：

同步依赖并更新锁文件。
构建包分发：这将在 dist/ 目录创建源码包和 wheel 包。
发布到 PyPI：注意需要通过环境变量或命令标志设置 PyPI 凭据——令牌：--token 或 UV_PUBLISH_TOKEN；或用户名/密码：--username / UV_PUBLISH_USERNAME 和 --password / UV_PUBLISH_PASSWORD。

调试

由于 MCP 服务器通过 stdio 运行，调试可能具有挑战性。为获得最佳调试体验，强烈建议使用 MCP Inspector。可通过 npm 命令启动，Inspector 将显示一个 URL，可在浏览器中访问以开始调试。也可通过命令查看服务器日志。

适用场景

让 AI 助手协助处理 Gmail 邮件：搜索、阅读、总结、起草和回复邮件。
让 AI 助手管理 Google 日历：查看日程、创建和删除事件、查找合适时间段。
需要在多个 Google 账号之间切换操作的场景。

限制

仅覆盖 Gmail 和 Google Calendar，其他 Google 产品暂未提供支持。
依赖 Google Workspace API 与 OAuth2 认证，用户需自行在 Google Cloud Console 完成应用和凭据配置。
首次使用每个账号需通过浏览器完成授权。
关于收费、价格等信息暂未提供。