适合谁
- 需要集中访问多个 Google Workspace 服务的个人用户和团队。
- 需要按工具层级、服务或权限范围部署的开发者。
- 需要自托管、多用户 OAuth 2.1 或容器化部署的组织。
- 希望通过 CLI 调用 MCP 工具的开发者。
G
56FMRS · C
基于提供的仓库说明和 server.json，该项目是活跃的第三方 Google Workspace MCP 服务器，版本 1.22.2，PyPI 包为 workspace-mcp，采用 stdio 和 streamable HTTP。它覆盖面广、可自托管且使用 MIT 许可证，但需要用户自行配置 Google Cloud、OAuth 和 API 权限；Google Chat 还存在额外账号与应用配置要求。
Google Workspace MCP Server 是一个 MIT 许可的开源 MCP 服务器和 CLI 工具，可通过 Google API 为 AI 助手提供 Gmail、Drive、Calendar、Docs、Sheets、Slides、Forms、Tasks、Contacts、Chat、Apps Script 和 Custom Search 能力。它支持分级工具、按服务选择、只读模式、细粒度权限、OAuth 2.0/2.1，以及面向多用户部署的无状态模式。
工具能力
search_gmail_messages
使用 Gmail 查询运算符搜索邮件。
send_gmail_message
发送电子邮件，并支持文件附件。
get_events
按时间范围获取日历事件。
manage_event
创建、更新或删除日历事件。
search_drive_files
使用查询语法搜索 Drive 文件。
get_drive_file_content
读取 Office 文件、PDF 和图像内容。
create_drive_file
创建文件或从 URL 获取文件。
manage_drive_access
授予、更新、撤销权限或转移所有权。
get_doc_content
提取 Google Docs 文档文本。
create_doc
创建新文档。
modify_doc_text
插入、替换并格式化文档文本。
read_sheet_values
读取电子表格单元格范围。
modify_sheet_values
写入、更新或清除单元格。
create_spreadsheet
创建新电子表格。
format_sheet_range
设置单元格颜色、数字格式、对齐方式和字体样式。
create_presentation
创建新演示文稿。
get_presentation
获取演示文稿详情。
create_form
创建新表单。
list_form_responses
分页列出表单回复。
list_tasks
按条件列出任务。
manage_task
创建、更新、删除或移动任务。
search_contacts
按姓名、电子邮件或电话搜索联系人。
manage_contact
创建、更新或删除联系人。
get_messages
获取 Google Chat 空间中的消息。
send_message
向 Chat 空间发送消息。
search_messages
搜索 Chat 历史记录。
search_custom
通过 Google Programmable Search Engine 执行网页搜索。
list_script_projects
列出可访问的 Apps Script 项目。
run_script_function
使用参数执行 Apps Script 函数。
安装接入
需要 Python 3.10+、uv/uvx 和 Google Cloud 项目中的 OAuth 2.0 凭据。设置 GOOGLE_OAUTH_CLIENT_ID；机密客户端设置 GOOGLE_OAUTH_CLIENT_SECRET。可使用 uvx workspace-mcp 启动 stdio，或使用 uvx workspace-mcp --transport streamable-http 启动推荐的 HTTP 模式。现代客户端推荐使用 streamable HTTP 和 OAuth 2.1；Claude Desktop 也可通过 Connector 连接。启用具体 Google API，并为 Chat 额外配置 Chat 应用；Chat 仅支持 Google Workspace 账号。
claude_desktop_config.json
{"mcpServers":{"google_workspace":{"command":"uvx","args":["workspace-mcp"],"env":{"GOOGLE_OAUTH_CLIENT_ID":"your-client-id","GOOGLE_OAUTH_CLIENT_SECRET":"your-secret","OAUTHLIB_INSECURE_TRANSPORT":"1"}}}}
选型与风险
不适合谁
- 需要官方 Google 维护服务器的用户。
- 只有个人 @gmail.com 账号且需要 Google Chat 的用户。
- 不希望配置 Google Cloud OAuth 凭据或启用相关 API 的用户。
- 需要未经授权访问 Google Workspace 数据的应用。
所需权限
- 需要 Google Cloud OAuth 客户端凭据。
- 所需 Google API 的 OAuth 权限取决于启用的服务和工具。
- 支持只读权限、按服务的细粒度权限和完整访问权限。
- Drive、Gmail 等写入工具需要相应写入权限。
- Google Chat 需要配置 Chat 应用，并使用 Google Workspace 账号。
- 可选的服务账号模式需要服务账号凭据和域范围委派。
风险与副作用
- 启用完整工具和写入权限可能允许修改、发送、删除或共享用户数据。
- 公开部署时，未限制动态客户端注册的重定向 URI 可能带来钓鱼风险。
- stdio 是旧版回退模式；远程或共享部署应使用 OAuth 2.1。
- 本地附件和凭据存储会写入配置的本地目录；无状态模式不写入文件。
- Google API 配额、OAuth 同意配置和账号权限可能限制功能。
- Chat API 对个人 Gmail 账号不可用。
常见排障
- 确认 Python 版本至少为 3.10，并已安装 uv/uvx。
- 检查 OAuth 客户端 ID、客户端密钥、重定向 URI 和开发环境中的 OAUTHLIB_INSECURE_TRANSPORT。
- 确认所需 Google API 已在 Google Cloud 项目中启用。
- 若 Chat 工具失败，确认已配置 Chat 应用的名称、头像 URL 和描述，并使用 Workspace 账号。
- 现代客户端优先使用 --transport streamable-http；OAuth 2.1 不能与 --single-user 或服务账号模式组合。
- 远程服务器处理附件时，应发送 Base64 内容，而不是依赖客户端本地文件路径。
使用场景
搜索和处理 Gmail 邮件。
管理日历事件和空闲/忙碌信息。
读写 Drive 文件、Docs、Sheets 和 Slides。
创建和处理 Forms、Tasks、Contacts 与 Chat 内容。
通过 Apps Script 执行跨应用自动化。
使用 Custom Search 执行可配置的网站搜索。
支持客户端
Claude Desktop完整支持
Claude Code完整支持
VS Code完整支持
LM Studio完整支持