Gmail & Google Calendar

🚀 mcp-gsuite MCP 服务器

与 Google 产品交互的 MCP 服务器，借助它可以轻松实现与 Gmail 和日历等 Google 服务的集成。

🚀 快速开始

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

✨ 主要特性

通用特性

• 支持多个 Google 账户。

Gmail 功能

• 获取您的 Gmail 用户信息。
• 使用灵活搜索查询电子邮件（例如，未读邮件、来自特定发件人的邮件、日期范围、带附件的邮件）。
• 通过 ID 检索完整的电子邮件内容。
• 创建新草稿邮件，支持收件人、主题、正文和附件。
• 发送电子邮件。
• 删除电子邮件。

日历功能

• 获取 Google 日历的所有事件。
• 创建新的日历事件。
• 更新现有日历事件。
• 删除日历事件。

📦 安装指南

MCP 服务器可以通过命令行参数指定自定义路径来管理身份验证和账户信息：

• --gauth-file：指定包含 OAuth2 客户端配置的 .gauth.json 文件路径，默认为当前目录。
• --accounts-file：指定包含 Google 账户信息的 .accounts.json 文件路径，默认为当前目录。
• --credentials-dir：指定身份验证凭据存储的目录，默认为当前目录，每个账户单独保存为 .oauth.{email}.json。

示例用法：

uv run mcp-gsuite --gauth-file /path/to/custom/.gauth.json --accounts-file /path/to/custom/.accounts.json --credentials-dir /path/to/custom/credentials

这些选项在开发和测试场景中非常有用，特别是在需要管理多个配置或环境时。

💻 使用示例

基础用法

目前文档未提供基础使用的代码示例，可参考配置选项中的命令行示例来启动服务器。

高级用法

目前文档未提供高级使用的代码示例，可参考开发部分的构建、发布和调试相关命令。

📚 详细文档

开发

构建与发布

要准备发行版本：

1. 同步依赖项并更新锁定文件：

uv sync

2. 构建发行版：

uv build

这将在 dist/ 目录下创建源代码和轮格式分布。 3. 发布到 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