G Suite Integration

🚀 mcp-gsuite MCP服务器

与Google产品交互的MCP服务器，借助它可实现与Gmail、日历等Google服务的便捷集成。

🚀 快速开始

此MCP服务器支持Gmail和日历集成，能与Google产品进行交互。

✨ 主要特性

通用特性

• 支持多个Google账户。

Gmail相关特性

• 获取您的Gmail用户信息。
• 使用灵活搜索查询邮件（例如，未读、来自特定发件人、日期范围、带有附件）。
• 按ID检索完整的电子邮件内容。
• 创建新的草稿邮件，带有收件人、主题、正文和抄送选项。
• 删除草稿邮件。
• 回复现有邮件（可以立即发送或保存为草稿）。
• 一次按其ID检索多个邮件。
• 将多个附件从邮件保存到本地系统。

日历相关特性

• 管理多个日历。
• 在指定时间范围内获取日历事件。
• 创建带有以下内容的日历事件：
  • 标题，开始/结束时间。
  • 可选位置和描述。
  • 可选与会者。
  • 自定义时区支持。
  • 通知偏好设置。
• 删除日历事件。

示例提示

您可以尝试以下示例提示来体验服务器功能：

• 获取我最新的未读消息。
• 搜索来自Scrum Master的邮件。
• 获取会计的所有邮件。
• 查看关于ABC的邮件并进行摘要。
• 写一封感谢Alice最后一封邮件的回复并保存为草稿。
• 回复Bob的邮件，内容为“非常感谢”。将其作为草稿存储。
• 我明天的日程安排是什么？
• 这周我有哪些会议？
• 在我的日历中找到所有与客户A相关的事件。

📚 详细文档

MCP服务器可以配置为指定自定义路径用于身份验证和账户信息的选项：

• --gauth-file：指定包含OAuth2客户端配置的.gauth.json文件的路径。默认是./.gauth.json。
• --accounts-file：指定包含Google账户信息的.accounts.json文件的路径。默认是./.accounts.json。
• --credentials-dir：指定在成功身份验证后存储OAuth凭证的目录。默认是在当前工作目录中，每个账户都有一个子目录.oauth.{email}.json。

这些选项在开发和测试场景中特别有用，特别是在需要不同配置或不适合默认路径的环境中部署时。

🔧 技术细节

构建和发布

要准备分发包，可按以下步骤操作：

# 同步依赖项并更新锁定文件
uv sync

# 构建包分布
uv build

这将在dist/目录中创建源代码和轮式发行版。

# 发布到PyPI
uv publish

注意：您需要通过环境变量或命令标志设置PyPI凭据：

• 令牌：--token 或 UV_PUBLISH_TOKEN。
• 或用户名/密码：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD。

调试

由于MCP服务器通过stdio运行，调试可能具有挑战性。为了获得最佳调试体验，我们强烈推荐使用MCP Inspector。

# 启动MCP Inspector
npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-gsuite run mcp-gsuite

启动后，Inspector会显示一个URL，您可以在浏览器中访问该URL以开始调试。

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