mcp-gsuite

🚀 mcp-gsuite MCP服务器

mcp-gsuite MCP服务器可实现与Google产品的交互，支持Gmail和日历集成，为用户提供便捷的Google服务操作体验。

🚀 快速开始

此MCP服务器支持Gmail和日历集成，能帮助用户更高效地管理Google账户相关的邮件和日程安排。

✨ 主要特性

通用特性

• 支持多个Google账户，方便用户同时管理不同的账号。

Gmail功能

• 获取Gmail用户信息，让您快速了解账户基本情况。
• 可使用灵活的搜索查询邮件，如查找未读邮件、来自特定发件人的邮件、特定日期范围内的邮件以及带附件的邮件等。
• 根据ID检索完整的电子邮件内容，精准获取所需邮件信息。
• 创建新的草稿邮件，支持设置收件人、主题、正文和抄送选项。
• 删除草稿邮件，清理无用的草稿。
• 回复现有邮件，可选择立即发送或保存为草稿。
• 一次根据ID检索多个邮件，提高邮件获取效率。
• 将多个附件从邮件保存到本地系统，方便保存重要附件。

日历功能

• 管理多个日历，轻松规划不同日程安排。
• 在指定时间范围内获取日历事件，清晰掌握日程情况。
• 创建日历事件，包括设置开始和结束时间、标题、地点和描述。
• 更新现有事件或创建新事件（如果重复），灵活调整日程。
• 获取所有当前用户的Google日历，全面了解日历信息。
• 根据ID检索单个事件，精准定位特定日程。
• 删除事件，及时清理不再需要的日程。

📦 安装指南

文档未提及安装步骤，故跳过此章节。

💻 使用示例

基础用法

此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服务器通过标准输入输出运行，调试可能具有挑战性。为了获得最佳调试体验，我们强烈推荐使用MCP Inspector。

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

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

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

📚 详细文档

此MCP服务器可通过命令行选项指定自定义路径来配置身份验证和账户信息，这些选项在开发和测试场景中非常有用，特别是在需要管理多个环境或不同的配置集时。

🔧 技术细节

文档未提及技术实现细节，故跳过此章节。

📄 许可证

文档未提及许可证信息，故跳过此章节。