Google Workspace MCP Server 是一个基于模型上下文协议（MCP）的服务器，旨在将个人 Google Workspace 账户（如 Gmail、Google Calendar 等）与任何支持 MCP 的 AI 客户端（例如 Claude Desktop）安全地连接起来。通过该服务器，AI 客户端可以在授权后直接与 Google Workspace 的各项服务进行交互。
主要能力
Google Calendar：在指定日期范围内列出和搜索主日历上的事件；创建包含标题、描述、开始和结束时间等详细信息的新事件；更新现有事件（支持部分修改，如更改标题或时间）；直接删除日历中的事件。
Gmail：读取最新邮件内容以保持信息更新；按主题行搜索特定邮件；直接从账户撰写并发送新邮件。
Google Drive：使用强大的查询字符串搜索文件和文件夹；创建具有指定标题和初始内容的 Google 文档；更新现有 Google 文档的全部内容；通过移至回收站或永久删除来管理文件。
使用方式
要运行该服务器，需要满足以下条件：Python 3.9+、uv（或 pip）、一个启用了必要 API 的 Google Cloud 项目、以及 Claude Desktop。
配置步骤：
- 配置 Google Cloud 项目：访问 Google Cloud 控制台创建新项目，在“API 和服务”->“库”中启用 Gmail API、Google Calendar API 和 Google Drive API。然后在“API 和服务”->“凭据”中创建 OAuth 客户端 ID，配置 OAuth 同意屏幕（选择外部，填写应用名称，添加自己的 Google 账户邮箱为测试用户），应用类型选择“桌面应用”，下载 JSON 凭据文件并重命名为 client_secrets.json，放在项目根目录。
- 安装依赖：克隆仓库并安装服务器和客户端所需的 Python 包。
- 运行一次性授权：在终端运行 get_credentials.py 脚本，浏览器将打开，登录 Google 账户并授予权限，脚本会自动创建 token.json 文件存储授权令牌。
- 设置并运行 AI 代理客户端：以 Claude Desktop 为例，在配置文件中添加 MCP 服务器配置，指定虚拟环境中 Python 可执行文件的绝对路径和 mcp_server.py 的绝对路径。
配置完成后，可以向 Claude 发出诸如“根据我收件箱中最后一封邮件的内容创建 Google 日历事件”、“创建一份旧金山旅行计划的 Google 文档”、“检查下周与客户进行两小时通话的空闲时间”、“将风投会议的开始时间改为上午 10 点”、“搜索收件箱中关于 AI 新闻的新邮件”、“给供应商发邮件说他迟到了，我需要尽快收到下一批货”等指令。
适用场景
适用于希望通过 AI 客户端自动化管理个人或团队 Google Workspace 事务的用户，例如自动安排会议、整理邮件、搜索和创建文档等。
限制与未来计划
当前功能覆盖 Google Calendar、Gmail 和 Google Drive 的部分操作。路线图显示未来将扩展 Google Docs（更细粒度的文档操作，如追加文本、读取特定部分）、Google Sheets（读取数据、追加行、更新单元格等）、以及为 Gmail、Calendar、Drive 增加更多功能。
该项目采用 MIT 许可证。欢迎贡献，可 fork 仓库并提交 pull request，重大更改请先开 issue 讨论。