使用说明
谷歌工作区MCP
适用于每个AI代理的Gmail、日历、驱动器、文档和表格工具 --克劳德、副驾驶、光标、Codex、双子座、风帆、Continue.dev和克莱恩。一个扩展名，8个代理，无需编辑任何配置文件。
安装。验证。让你的人工智能阅读电子邮件、查看日历或编辑电子表格。就这样
快速开始
- 安装 从 VS代码市场
- 验证 --安装向导在首次启动时出现
- 询问您的AI代理 关于你的谷歌工作区的任何信息
"Show me my unread emails"
"What meetings do I have today?"
"Find the budget spreadsheet in my Drive"
"Append a row to my tracking sheet"
先决条件
你需要 一 其中（向导将指导您）：
| 方法 | 最适合 | 你需要什么 |
|---|---|---|
| OAuth （推荐） | 个人Gmail/工作区帐户 | 具有OAuth凭据的Google Cloud项目 |
| 模数转换器 | 开发者与 gcloud CLI |
运行一个终端命令 |
| 服务账号 | 工作区管理/域范围委派 | JSON密钥文件+域管理设置 |
选项A:Auth2.0（浏览器登录）——推荐
- 首选 谷歌云控制台
- 创建项目（或选择现有项目）
- 启用所需的API：
- 首选 API和服务 > 图书馆
- 启用： Gmail API, 谷歌日历API, Google Drive API, 谷歌文档API, 谷歌网页API
- 创建OAuth凭据：
- 首选 API和服务 > 凭证
- 点击 创建凭据 > OAuth客户端ID
- 应用程序类型： 桌面应用
- 复制 客户端ID 和 客户端密钥
- 配置OAuth同意屏幕（如果提示）：
- 将自己添加为测试用户（如果是外部用户）
- 在扩展向导中，选择“OAuth”并粘贴您的客户端ID和密码
- 浏览器窗口打开>使用您的Google帐户登录>授权
选项B：应用程序默认凭据
gcloud auth application-default login \
--scopes=https://www.googleapis.com/auth/gmail.readonly,https://www.googleapis.com/auth/calendar.readonly,https://www.googleapis.com/auth/drive.readonly,https://www.googleapis.com/auth/documents.readonly,https://www.googleapis.com/auth/spreadsheets.readonly
选项C：服务帐户密钥
- 在Google Cloud Console中创建服务帐户
- 启用全域委派（访问Gmail需要）
- 下载JSON密钥文件
- 在扩展向导中，选择“服务帐户”并选择文件
可用工具（16）
Gmail（4个工具）
| 工具 | 它的作用 | 示例提示 |
|---|---|---|
gmail_list |
列出最近的电子邮件及其元数据 | “显示我最近的10封电子邮件” |
gmail_read |
按ID阅读完整的电子邮件内容 | “阅读约翰的电子邮件” |
gmail_search |
使用Gmail查询语法搜索电子邮件 | “查找来自的电子邮件boss@company.com本周” |
gmail_send |
发送电子邮件 | “发送电子邮件至team@company.com关于会议” |
Gmail管理员（大型工具）
| 动作 | 描述 |
|---|---|
create_draft |
创建新的电子邮件草稿 |
update_draft |
更新现有草稿 |
delete_draft |
删除草稿（需要确认） |
add_label / remove_label |
管理邮件标签 |
create_label / delete_label |
创建或删除标签 |
trash / untrash |
移入/移出垃圾桶（垃圾桶需要确认） |
mark_read / mark_unread |
切换读取状态 |
日历（2个工具）
| 工具 | 它的作用 | 示例提示 |
|---|---|---|
calendar_list_events |
列出即将举行的活动 | “我今天有什么会议？” |
calendar_get_event |
获取完整的活动详细信息 | “显示我下午3点会议的详细信息” |
日历管理（大型工具）
| 动作 | 描述 |
|---|---|
create_event |
创建新的日历事件 |
update_event |
更新事件详细信息 |
delete_event |
删除事件（需要确认） |
list_calendars |
列出所有日历 |
create_calendar |
创建新日历 |
驱动器（2个工具）
| 工具 | 它的作用 | 示例提示 |
|---|---|---|
drive_list |
列出驱动器或文件夹中的文件 | “显示驱动器中的文件” |
drive_search |
按内容或名称搜索文件 | “查找第四季度报告” |
驱动器管理（大型工具）
| 动作 | 描述 |
|---|---|
create_folder |
创建新文件夹 |
move / copy / rename |
文件操作 |
delete |
删除文件（需要确认） |
share / unshare |
管理共享权限 |
get_permissions |
查看当前权限 |
文档（1个工具）
| 工具 | 它的作用 | 示例提示 |
|---|---|---|
docs_read |
阅读谷歌文档的全文 | “阅读项目提案文档” |
文档管理（大型工具）
| 动作 | 描述 |
|---|---|
create |
创建新文档 |
append_text |
在文档末尾添加文本 |
insert_text |
在特定位置插入文本 |
replace_text |
查找和替换文本 |
delete_content |
删除内容范围（需要确认） |
表格（1个工具）
| 工具 | 它的作用 | 示例提示 |
|---|---|---|
sheets_read |
读取单元格数据或工作表元数据 | “显示工作表1中的数据！A1:D10” |
表格管理（大型工具）
| 动作 | 描述 |
|---|---|
create |
创建新的电子表格 |
append_rows |
向工作表添加行 |
update_cells |
更新单元格值 |
add_sheet |
添加新的图纸选项卡 |
delete_sheet |
删除工作表选项卡（需要确认） |
clear_range |
清除单元格范围（需要确认） |
安全
破坏性操作（删除、回收、清除）需要 confirm: true 执行。AI代理将收到警告，在继续之前必须明确确认。
支持的AI代理
扩展程序会自动注册到它检测到的每个AI代理：
| 代理 | 如何注册 | 配置文件 |
|---|---|---|
| VS代码Copilot | VS代码API（自动） | -- |
| 克劳德代码 | ~/.claude.json |
JSON |
| 光标 | ~/.cursor/mcp.json |
JSON |
| OpenAI Codex | ~/.codex/config.toml |
汤姆 |
| 谷歌双子座 | ~/.gemini/settings.json |
JSON |
| 风帆冲浪 | ~/.codeium/windsurf/mcp_config.json |
JSON |
| Continue.dev | ~/.continue/config.yaml |
YAML |
| Cline | VS代码全局存储 | JSON |
您可以在中打开/关闭单个代理 设置 >搜索 gwsMcp.agents.
设置
| 设置 | 默认值 | 说明 |
|---|---|---|
gwsMcp.authMethod |
"oauth" |
认证方式：oauth、adc、serviceAccount |
gwsMcp.agents.* |
true |
每个代理的注册切换 |
gwsMcp.registrationScope |
"global" |
全局或工作区注册 |
gwsMcp.autoStart |
true |
VS Code启动时自动启动服务器 |
gwsMcp.serverLogLevel |
"info" |
服务器日志冗长 |
命令
打开命令选项板(Cmd+Shift+P / Ctrl+Shift+P)并搜索：
| 命令 | 它做什么 |
|---|---|
Google Workspace MCP: Setup Authentication |
运行安装向导 |
Google Workspace MCP: Register with AI Agents |
向所有检测到的代理重新注册 |
Google Workspace MCP: Show Status |
显示身份验证方法和服务器状态 |
Google Workspace MCP: Restart MCP Server |
重新启动后台MCP服务器 |
Google Workspace MCP: Check Authentication Status |
验证凭据是否有效 |
Google Workspace MCP: View Server Logs |
打开输出通道进行调试 |
Google Workspace MCP: Remove from All Agents |
清理所有代理注册 |
故障排除
状态栏中的“GWS MCP:设置”
您的凭据尚未配置。单击状态栏项或运行 Google Workspace MCP: Setup Authentication.
“权限被拒绝”错误
您的凭据无法访问请求的服务。确保在您的Google Cloud项目中启用了所需的API。
服务器持续崩溃
跑 Google Workspace MCP: View Server Logs 查看错误。常见原因：
- 凭据过期>再次运行安装向导
- 找不到Node.js>安装Node.js 18+或扩展使用VS Code的捆绑运行时
- API未启用>在Google云控制台中启用相关的API
干净卸载
卸载前：运行 Google Workspace MCP: Remove from All Agents 清理配置文件。
隐私
此扩展：
- 不收集遥测数据 或将数据发送给第三方
- 仅使用您自己的凭据与Google Workspace API通信
- 将凭据存储在VS Code的内置SecretStorage中（加密，每个用户）
- OAuth刷新令牌永远不会离开您的计算机
释放
释放是由标签触发的。要剪切新版本，请执行以下操作：
npm version minor # or patch / major — bumps package.json, commits, and tags
git push --follow-tags
GitHub Actions收购了 v* 标签，运行类型检查+测试，打包 .vsix，并发布附带的GitHub版本。
