Google Workspace MCP 服务器

这是一个模型上下文协议（MCP）服务器，作为您的个人 Google Workspace 账户（如 Gmail、日历等）与任何兼容 MCP 的 AI 客户端（例如 Claude Desktop）之间的安全桥梁。

功能

• Google 日历：
  • 在特定日期范围内轻松列出和搜索您主要日历上的事件。
  • 使用标题、描述、开始时间和结束时间等详细信息创建新事件。
  • 更新现有事件，允许部分修改，如更改标题或时间。
  • 直接从您的日历中删除事件。
• Gmail：
  • 阅读最新的电子邮件内容以保持最新状态。
  • 通过主题行搜索特定电子邮件以找到重要对话。
  • 直接从您的账户发送新的电子邮件。
• Google 驱动器：
  • 使用强大的查询字符串搜索文件和文件夹。
  • 创建具有指定标题和初始内容的新 Google 文档。
  • 更新现有 Google 文档的全部内容。
  • 通过移动到回收站或永久删除来管理您的文件。

快速入门

按照以下步骤设置服务器并运行示例 AI 代理。

先决条件

• Python 3.9+ 和 uv（或 pip）。
• 启用了必要 API 的 Google Cloud 项目。
• Claude Desktop。

第一步：配置您的 Google Cloud 项目

您需要授权此应用程序访问您的 Google 数据。这是一次性设置。

1. 转到 Google Cloud 控制台：https://console.cloud.google.com/
2. 创建一个新项目（或使用现有的项目）。
3. 启用 API：
   • 转到“API和服务”->“库”。
   • 搜索并启用“Gmail API”。
   • 搜索并启用“Google 日历 API”。
   • 搜索并启用“Google 驱动器 API”。
4. 创建 OAuth 凭据：
   • 转到“API和服务”->“凭据”。
   • 单击“创建凭据”->“OAuth 客户端 ID”。
   • 如果提示，请配置“OAuth 同意屏幕”。选择外部并提供应用名称。对于个人用途，可以跳过大多数其他字段。添加您的 Google 账户电子邮件作为测试用户。
   • 对于“应用类型”，选择桌面应用。
   • 给它命名（例如，“GSuite MCP 客户端”）。
5. 下载凭据：
   • 创建客户端 ID 后，单击“下载 JSON”图标。
   • 将下载的文件重命名为 client_secrets.json 并放置在项目的根目录中。

第二步：安装依赖项

克隆此仓库并安装服务器和客户端所需的 Python 包。

git clone <your-repo-url>
cd <your-repo-name>
uv venv # 创建虚拟环境
source .venv/bin/activate # 在 Windows 上：.venv\Scripts\activate
# 安装服务器依赖项
uv install -r requirements.txt

第三步：运行一次性授权

在运行服务器之前，您需要使用您的 Google 账户对其进行授权。从终端运行 get_credentials.py 脚本：

python get_credentials.py

• 这将打开一个浏览器窗口。
• 使用您的 Google 账户登录并授予请求的权限。
• 批准后，脚本会自动在项目目录中创建一个 token.json 文件。该文件存储您的授权令牌，因此您不必每次都登录。

第四步：设置并运行 AI 代理客户端

作为一个示例，我将向您展示如何配置 Claude Desktop 作为 MCP 客户端。然而，您可以使用互联网上可用的任何 MCP 客户端。

1. 配置 Claude Desktop：

   （Windows）打开 C:\Users\<user>\AppData\Roaming\Claude\claude_desktop_config.json 并添加

   {
       "mcpServers": {
           "GsuiteMCPServer": {
               "command": "绝对路径到虚拟环境中的Python可执行文件",
               "args": [
                   "<mcp_server.py-绝对路径>"
               ]
           }
       }
   }   
   

2. 使用可用工具： 向 Claude 提问类似以下问题：

   • 根据发到我的收件箱的最后一封邮件的内容创建一个 Google 日历事件。 如果无法创建事件，则创建一个提醒事件，以便提醒我查看该电子邮件。

   • 创建一个关于旧金山旅行计划的 Google 文档草稿。

   • 查看我下周是否有两个小时的空闲时间与客户通话。

   • 编辑与风险投资家会议的开始时间为上午10点。

   • 搜索我的收件箱中有关人工智能新闻的新电子邮件。

   • 发送一封电子邮件给我的供应商，告诉他他迟到了，我需要尽快收到下一批货物。

   • 更多。

发展路线图及未来计划

此服务器是更大愿景的基础。目标是为整个 Google Workspace 套件提供全面的 MCP 服务器。未来的添加将包括：

• 📝 Google 文档：更细粒度的文档操作，例如追加文本或阅读特定部分，而不是覆盖整个文件。
• 📊 Google 表格：从表格中读取数据，追加新行，更新单元格，甚至执行计算。
• 📨 新功能Gmail。
• 📅 新功能Google 日历。
• 🗂️ 新功能Google 驱动器。

欢迎贡献！

贡献

如果您想贡献，请随意分叉仓库并提交拉取请求。对于重大更改，请先打开一个问题进行讨论。

许可证

此项目根据 MIT 许可证发布。详情见 LICENSE 文件。 </中文翻译>