Skip to main content
Glama
google-workspace-mcp

google-workspace-mcp

by Sejin-Koo

google-workspace-mcp

处理 Google Workspace(Sheets / Docs / Slides / Forms)与 Google Drive 的 MCP 服务器。

Cowork 默认连接官方 "Google Drive" 连接器仅支持搜索、读取、创建文件、移入回收站, 无法修改已有文件的内容。因此,即使只想在表格中新增一行,也只能把全部数据重新做成新文件、丢弃原文件。本服务器填补了这一空白——在保持文件 ID 不变的前提下,向表格追加行、修改文档正文、添加幻灯片。

提供的工具

工具

功能

sheets_values

单元格值 read / append(追加行) / update / clear

sheets_manage

创建电子表格,添加、删除、重命名标签页,查询元数据,batchUpdate

docs_read

以文本(含表格)或原始结构读取文档

docs_write

创建文档、末尾追加、指定位置插入、查找替换、batchUpdate

slides_read

按幻灯片查询文本、演讲者备注

slides_write

创建演示文稿、添加幻灯片(填充标题、正文)、删除、查找替换

forms_tool

创建、查询问卷,查询响应列表、单条响应,batchUpdate

drive_search

按文件名、全文搜索、MIME、文件夹条件搜索

drive_file

元数据、创建、创建文件夹、替换内容(保持 ID)、重命名、移动、复制、移入回收站、彻底删除、下载、export

drive_comments

查询、撰写评论,回复、解决、删除

drive_revisions

查询版本历史、取回历史版本内容、固定保留

drive_permissions

检查、添加、修改、解除共享权限

drive_shared_drives

共享云端硬盘列表、详情

drive_changes

获取起始令牌后仅查询其后的变更

所有工具均可通过 max_chars 调节响应长度上限,设为 0 则不截断。

Related MCP server: Google Docs, Drive & Sheets MCP Server

环境变量

名称

说明

GOOGLE_CLIENT_ID

OAuth 客户端 ID

GOOGLE_CLIENT_SECRET

OAuth 客户端密钥

GOOGLE_REFRESH_TOKEN

包含 https://www.googleapis.com/auth/drive 作用域的 refresh token

MCP_GATE_KEYS

访问门禁允许的密钥列表(逗号分隔)。为空则禁用门禁

MCP_GATE_MODE

设为 enforce 时,无密钥的调用将被 401 拒绝

仅凭 drive 一个作用域即可覆盖 Sheets、Docs、Slides、Forms API 与 Drive API 的全部功能 (各 API 官方认证作用域列表中均包含 auth/drive)。

准备 Google Cloud 项目

与作用域无关,你需要在项目中**启用(Enable)**要使用的 API。 若不启用,会报 403 has not been used in project ... or it is disabled。

  • Google Sheets API / Google Docs API / Google Slides API / Google Forms API

  • Google Drive API

调用

https://<배포도메인>/api/mcp?k=<게이트키>

本地冒烟测试

将上述 3 个 Google 凭据填入 scripts/.env.local.json(已被 gitignore)后:

npm install
npm test

会在真实 Google 账户中创建测试文件,最后统一移入回收站清理。

Related MCP Connectors

Related MCP Servers