内容
# Google MCP 服务器
适用于 Google Workspace 的模型上下文协议（MCP）服务器。**279 个工具**，涵盖 Drive、Calendar、Docs、Sheets、Slides、Forms、Classroom、Meet 和 Drive Labels — 所有功能均通过单一、安全、MCP 服务器实现。
## 功能
- **279 个工具**，涵盖 9 个 Google Workspace API
- **自动 OAuth2 重新身份验证** — 当令牌过期时，浏览器会自动打开
- **自动更新** — 每次启动时从 GitHub 自动更新
- **Claude 技能安装** — 工具立即在 Claude 中可用
- 安全的凭证存储（配置文件中没有密钥）
- 与 Claude Desktop、OpenCode、Kilo Code、Cline 和 Cursor 兼容
## 支持的 API
| API | 工具 | 主要功能 |
|-----|-------|------------------|
| Google Drive | 35 | 文件、文件夹、权限、共享、评论、修订、共享驱动器 |
| Google Calendar | 26 | 事件、日历、空闲/忙碌、重复事件、ACL、ICS 导入 |
| Google Docs | 20 | 创建、编辑、格式化、表格、图像、列表、查找/替换、导出 |
| Google Sheets | 47 | 单元格、公式、图表、数据透视表、验证、保护、元数据 |
| Google Slides | 34 | 演示文稿、幻灯片、形状、文本、图像、对齐、样式 |
| Google Forms | 44 | 所有问题类型、测验、章节、响应、分析 |
| Google Classroom | 45 | 课程、作业、提交、成绩、班级名单、监护人 |
| Google Meet | 12 | 会议、录音、转录、日历集成 |
| Google Drive Labels | 24 | 标签、字段、选项、应用、修订、权限 |
## 先决条件
- 已安装 Node.js 18+
- 已安装 Claude Desktop（或其他 MCP 兼容客户端）
- 一个 Google 账户
## 快速设置
### 选项 A：Windows 安装程序（推荐）
**一键安装适用于 Windows。** 安装程序会自动处理所有内容：
1. 将 `key.json` 放在项目根目录（参见下面的“获取 Google API 凭证”）
2. 双击 `CPP/installer.exe`
3. 安装程序将：
- 检查是否已安装 Node.js 和 Claude Desktop
- 运行 `npm install` 和 `npm run build`
- 引导您完成 Google OAuth（打开浏览器）
- 自动配置 Claude Desktop
- 为 Claude 安装所有技能
4. Claude Desktop 打开 — 您已经准备好开始使用
**自动更新：** 安装完成后，MCP 服务器每次启动时都会从 GitHub 检查更新。如果有新版本可用，它会在后台自动拉取最新代码并重建。无需手动更新。
**拖放支持：** 您也可以直接将 `key.json` 拖放到 `installer.exe` 上。
### 选项 B：手动设置
#### 1. 安装
```bash
git clone https://github.com/leeisfailing/google-mcp.git
cd google-mcp
npm install
npm run build
```
### 2. 获取 Google API 凭证
1. 前往 [Google Cloud Console](https://console.cloud.google.com/)
2. 创建一个新项目（例如，“Google MCP”）
3. 启用以下 API：
- [Google Drive API](https://console.cloud.google.com/apis/library/drive.googleapis.com)
- [Google Calendar API](https://console.cloud.google.com/apis/library/calendar-json.googleapis.com)
- [Google Docs API](https://console.cloud.google.com/apis/library/docs.googleapis.com)
- [Google Sheets API](https://console.cloud.google.com/apis/library/sheets.googleapis.com)
- [Google Slides API](https://console.cloud.google.com/apis/library/slides.googleapis.com)
- [Google Forms API](https://console.cloud.google.com/apis/library/forms.googleapis.com)
- [Google Classroom API](https://console.cloud.google.com/apis/library/classroom.googleapis.com)
- [Google Meet API](https://console.cloud.google.com/apis/library/meet.googleapis.com)
- [Google Drive Labels API](https://console.cloud.google.com/apis/library/drivelabels.googleapis.com)
4. 前往 [Credentials](https://console.cloud.google.com/apis/credentials)
5. 点击“创建凭证”>“OAuth 客户端 ID”
6. 配置 OAuth 同意屏幕（如果提示）：
- 选择“外部”用户类型
- 填写应用名称（例如，“Google MCP”）
- 添加您的电子邮件作为开发者联系人
- 保存并继续完成步骤
7. 选择“桌面应用”作为应用类型
8. 命名并点击“创建”
9. 点击下载图标下载 `credentials.json`
### 3. 放置凭证
复制下载的 JSON 文件，并将其重命名为 `key.json`，放在项目根目录：
```
google-mcp/
key.json # 重命名您的下载文件为此
src/
package.json
...
```
### 4. 首次运行（一次性 OAuth）
```bash
npm start
```
首次运行时，服务器将：
1. 检测 `key.json` 并加载您的客户端 ID/密钥
2. 检测到没有 `token.json` 存在
3. 为 Google OAuth 同意打开您的浏览器
4. 自动将刷新令牌保存到 `token.json`
之后，`token.json` 已保存，您永远不需要再次身份验证。如果令牌过期，服务器会自动打开浏览器进行重新身份验证。
### 5. 配置您的 AI 客户端
**您的配置文件中没有密钥！** 服务器会自动从文件中读取。
#### Claude Desktop
**配置文件位置：**
- Windows: `C:\Users\User\AppData\Local\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude`
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Linux: `~/.config/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"google-mcp": {
"command": "node",
"args": ["C:\\Users\\You\\Desktop\\google-mcp\\auto-update.js"]
}
}
}
```
> **注意：** Claude Desktop 使用 `auto-update.js`，它在启动时自动从 GitHub 检查更新并安装技能。
#### OpenCode
**配置文件位置：** `~/.config/opencode/opencode.jsonc`
```jsonc
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"google-mcp": {
"type": "local",
"command": ["node", "/absolute/path/to/google-mcp/build/index.js"]
}
}
}
```
#### Kilo Code
**配置文件位置：** `~/.config/kilo/kilo.jsonc`
```jsonc
{
"mcp": {
"google-mcp": {
"type": "local",
"command": ["node", "/absolute/path/to/google-mcp/build/index.js"]
}
}
}
```
#### Cline / Roo Code
**配置文件位置：** `~/.cline/mcp_settings.json` 或 `~/.roo/mcp_settings.json`
```json
{
"mcpServers": {
"google-mcp": {
"command": "node",
"args": ["/absolute/path/to/google-mcp/build/index.js"]
}
}
}
```
#### Cursor
**配置文件位置：** `~/.cursor/mcp.json`
```json
{
"mcpServers": {
"google-mcp": {
"command": "node",
"args": ["/absolute/path/to/google-mcp/build/index.js"]
}
}
}
```
### 6. 重启您的 AI 客户端
重启 Claude Desktop / OpenCode / Kilo Code / Cline 以加载 MCP。
## 项目结构
```
google-mcp/
key.json # 您的 Google OAuth 客户端凭证（保持机密）
token.json # 自动生成的刷新令牌（保持机密）
auto-update.js # Claude Desktop 的自动更新包装器
.gitignore # 防止提交机密
src/
index.ts # 具有模块化架构的 MCP 服务器
test-oauth.ts # OAuth 令牌测试实用程序
services/
drive.ts # Google Drive API（35 个工具）
calendar.ts # Google Calendar API（26 个工具）
docs.ts # Google Docs API（20 个工具）
sheets.ts # Google Sheets API（47 个工具）
slides.ts # Google Slides API（34 个工具）
forms.ts # Google Forms API（44 个工具）
classroom.ts # Google Classroom API（45 个工具）
meet.ts # Google Meet API（12 个工具）
labels.ts # Google Drive Labels API（24 个工具）
api-utils.ts # API 错误处理和启用指南
skills/
google-mcp/
SKILL.md # 具有所有 279 个工具的 Claude 技能
CPP/
installer.cpp # Windows 安装程序源代码
build.bat # 安装程序的构建脚本
build/ # 编译输出
```
## 可用工具（279）
### Google Drive（35 个工具）
| 工具 | 描述 |
|------|-------------|
| `list_drive_files` | 使用查询、分页、字段过滤列出文件 |
| `get_drive_file` | 按 ID 获取文件元数据 |
| `create_drive_file` | 上传/创建具有名称、MIME、父级的文件 |
| `update_drive_file` | 更新文件元数据（名称、描述、父级） |
| `delete_drive_file` | 删除或回收站文件 |
| `copy_drive_file` | 复制文件到新位置/名称 |
| `download_drive_file` | 获取文件内容/下载 URL |
| `search_drive_files` | 完整的 Drive 查询语法搜索 |
| `create_drive_folder` | 创建具有父级的文件夹 |
| `list_drive_folder_contents` | 列出文件夹的内容 |
| `move_drive_file` | 移动文件到不同的父级 |
| `add_drive_permission` | 添加用户/组/域/任意权限 |
| `list_drive_permissions` | 列出文件的所有权限 |
| `update_drive_permission` | 更改权限角色 |
| `remove_drive_permission` | 删除权限 |
| `share_drive_file` | 快速共享邮件 + 角色 |
| `add_drive_comment` | 添加文件评论 |
| `list_drive_comments` | 列出文件评论 |
| `resolve_drive_comment` | 标记评论为已解决 |
| `list_drive_revisions` | 列出文件修订 |
| `get_drive_revision` | 获取特定修订 |
| `delete_drive_revision` | 删除修订 |
| `star_drive_file` | 标记/取消标记文件 |
| `set_drive_file_properties` | 设置自定义应用属性 |
| `list_shared_drives` | 列出所有共享驱动器 |
| `get_shared_drive` | 获取共享驱动器详情 |
| `create_shared_drive` | 创建新的共享驱动器 |
| `delete_shared_drive` | 删除共享驱动器 |
| `get_drive_about` | 获取存储配额、用户信息 |
| `create_drive_shortcut` | 创建文件快捷方式 |
| `get_drive_shortcut_target` | 获取快捷方式目标 |
| `export_drive_file` | 导出 Workspace 文件（PDF、DOCX 等） |
| `batch_update_drive_files` | 批量更新多个文件 |
### Google Calendar（26 个工具）
| 工具 | 描述 |
|------|-------------|
| `list_calendars` | 列出所有日历 |
| `get_calendar` | 获取日历详情 |
| `create_calendar` | 创建新日历 |
| `update_calendar` | 更新摘要/描述 |
| `delete_calendar` | 删除日历 |
| `get_calendar_colors` | 获取可用颜色 |
| `get_calendar_settings` | 获取用户设置 |
| `list_events` | 列出具有时间范围、查询筛选器的事件 |
| `get_event` | 获取事件详情 |
| `create_event` | 创建具有与会者、Meet 链接、重复事件的事件 |
| `update_event` | 更新事件属性 |
| `delete_event` | 删除事件 |
| `quick_add_event` | 从自然语言创建事件 |
| `move_event` | 将事件移动到另一个日历 |
| `watch_events` | 设置推送通知 |
| `update_recurring_event_instance` | 更新重复事件的单个实例 |
| `delete_recurring_event_instance` | 删除重复事件的单个实例 |
| `get_freebusy` | 查询日历的空闲/忙碌状态 |
| `get_calendar_list_freebusy` | 获取所有日历的空闲/忙碌状态 |
| `get_event_colors` | 获取事件颜色选项 |
| `watch_calendar_list` | 监视日历更改 |
| `stop_channel` | 停止通知通道 |
| `list_calendar_acl` | 列出访问控制规则 |
| `add_calendar_acl` | 添加访问控制规则 |
| `delete_calendar_acl` | 删除访问控制规则 |
| `import_event` | 从 ICS 导入事件 |
**事件创建参数：** 摘要、描述、地点、开始日期/时间、结束日期/时间、时区、与会者（电子邮件数组）、重复事件（RRULE 字符串）、会议数据版本（用于 Meet 链接）、发送通知、透明度、可见性、颜色 ID、提醒。
### Google Docs（20 个工具）
| 工具 | 描述 |
|------|-------------|
| `docs_create_document` | 创建新文档 |
| `docs_get_document` | 获取完整文档结构 |
| `docs_get_document_plain_text` | 获取纯文本 |
| `docs_delete_document` | 删除文档 |
| `docs_insert_text` | 在索引处插入文本 |
| `docs_insert_paragraph` | 插入具有样式的段落 |
| `docs_insert_page_break` | 插入分页符 |
| `docs_insert_table` | 插入具有行/列/单元格内容的表格 |
| `docs_insert_image` | 从 URL 插入图像 |
| `docs_insert_bullet_list` | 插入项目符号列表 |
| `docs_insert_numbered_list` | 插入编号列表 |
| `docs_insert_named_range` | 创建命名范围/书签 |
| `docs_update_paragraph_style` | 标题、Alignment、Indent、Spacing |
| `docs_update_text_format` | 粗体、斜体、下划线、字体、大小、颜色 |
| `docs_delete_content_range` | 删除范围内的内容 |
| `docs_merge_table_cells` | 合并表格单元格 |
| `docs_unmerge_table_cells` | 分割表格单元格 |
| `docs_find_and_replace` | 查找/替换（支持正则表达式） |
| `docs_replace_all_text` | 替换所有出现 |
| `docs_export_document` | 导出为 PDF/DOCX/HTML/TXT |
**文档索引：** 0-based，索引 0 = 文档开始后的第一个位置。使用 `endOfSegmentLocation: {}` 在末尾追加。
### Google Sheets（47 个工具）
| 工具 | 描述 |
|------|-------------|
| `create_spreadsheet` | 创建新电子表格 |
| `delete_spreadsheet` | 删除电子表格 |
| `get_spreadsheet` | 获取电子表格详情 |
| `list_spreadsheets` | 列出所有电子表格 |
| `add_sheet` | 添加新选项卡 |
| `delete_sheet` | 删除选项卡 |
| `rename_sheet` | 重命名选项卡 |
| `list_sheets` | 列出所有选项卡 |
| `read_range` | 读取单元格值（A1 表示法） |
| `write_range` | 写入范围值 |
| `append_rows` | 在现有数据后追加行 |
| `clear_range` | 清除范围内容 |
| `format_cells` | 应用格式（粗体、颜色、边框等） |
| `merge_cells` | 合并单元格范围 |
| `run_formula` | 在单元格中设置公式 |
| `filter_data` | 过滤/排序数据 |
| `create_chart` | 创建图表（条形图、折线图、饼图、散点图等） |
| `update_chart` | 更新图表规格 |
| `delete_chart` | 删除图表 |
| `list_charts` | 列出所有图表 |
| `add_conditional_format_rule` | 添加条件格式 |
| `update_conditional_format_rule` | 更新规则 |
| `delete_conditional_format_rule` | 删除规则 |
| `list_conditional_format_rules` | 列出所有规则 |
| `add_data_validation` | 添加数据验证（列表、复选框等） |
| `update_data_validation` | 更新验证规则 |
| `delete_data_validation` | 删除验证 |
| `list_data_validations` | 列出所有验证 |
| `add_protected_range` | 保护范围 |
| `update_protected_range` | 更新保护设置 |
| `delete_protected_range` | 删除保护 |
| `list_protected_ranges` | 列出保护范围 |
| `add_developer_metadata` | 附加元数据 |
| `get_developer_metadata` | 获取元数据 |
| `search_developer_metadata` | 搜索元数据 |
| `delete_developer_metadata` | 删除元数据 |
| `create_pivot_table` | 创建数据透视表 |
| `create_named_range` | 创建命名范围 |
| `update_named_range` | 更新命名范围 |
| `delete_named_range` | 删除命名范围 |
| `list_named_ranges` | 列出所有命名范围 |
| `update_sheet_properties` | 更新选项卡颜色、隐藏、网格、冻结 |
| `duplicate_sheet` | 复制选项卡 |
| `copy_sheet` | 复制选项卡到另一个电子表格 |
| `move_sheet` | 移动选项卡位置 |
| `update_sheet_tab_color` | 设置选项卡颜色（RGB） |
| `batch_update_spreadsheet` | 执行原始 batchUpdate |
| `find_replace_sheet` | 查找和替换（支持正则表达式） |
| `sort_range` | 按列排序 |
| `create_filter_view` | 创建筛选视图 |
| `update_filter_view` | 更新筛选视图 |
| `delete_filter_view` | 删除筛选视图 |
| `add_sparkline` | 添加内联迷你图 |
| `create_data_source` | 创建连接的数据源 |
| `list_data_sources` | 列出连接的源 |
| `add_slicer` | 添加切片器 UI 元素 |
**范围格式：** `Sheet1!A1:C3` 或 `A1:Z100` 或 `Sheet1!A:A`。`read_range` 返回值的 2D 数组。
### Google Slides（34 个工具）
| 工具 | 描述 |
|------|-------------|
| `slides_create_presentation` | 创建新演示文稿 |
| `slides_get_presentation` | 获取完整演示文稿 |
| `slides_delete_presentation` | 删除演示文稿 |
| `slides_list_presentation_slides` | 列出所有幻灯片 |
| `slides_add_slide` | 添加幻灯片（按布局或空白） |
| `slides_delete_slide` | 删除幻灯片 |
| `slides_duplicate_slide` | 复制幻灯片 |
| `slides_move_slide` | 移动幻灯片位置 |
| `slides_get_slide` | 获取幻灯片详情 |
| `slides_create_shape` | 创建形状（矩形、椭圆等） |
| `slides_create_text_box` | 创建文本框 |
| `slides_create_image` | 从 URL 插入图像 |
| `slides_create_line` | 创建线条/箭头 |
| `slides_delete_element` | 删除元素 |
| `slides_group_elements` | 分组元素 |
| `slides_ungroup_elements` | 解组元素 |
| `slides_insert_text` | 在元素中插入文本 |
| `slides_update_text_style` | 粗体、斜体、字体、颜色 |
| `slides_update_paragraph_style` | 对齐、间距、缩进 |
| `slides_insert_table` | 插入表格 |
| `slides_update_table_cell_properties` | 单元格填充、边框、填充 |
| `slides_update_element_properties` | 位置、大小、旋转 |
| `slides_align_elements` | 对齐（左、中心、右、上、中、下） |
| `slides_distribute_elements` | 水平/垂直分布 |
| `slides_bring_to_front` | 置于顶层（Z 顺序） |
| `slides_send_to_back` | 置于底层（Z 顺序） |
| `slides_update_shape_fill` | 实心或渐变填充 |
| `slides_update_shape_border` | 边框颜色、权重、虚线 |
| `slides_update_shape_shadow` | 添加/删除阴影 |
| `slides_create_from_template` | 复制演示文稿（模板） |
| `slides_replace_image` | 原位替换图像 |
| `slides_refresh_sheets_chart` | 刷新链接的图表 |
| `slides_export_presentation` | 导出为 PDF/PPTX |
| `slides_set_slide_notes` | 设置演讲者备注 |
| `slides_get_slide_notes` | 获取演讲者备注 |
**单位：** 使用 `unit: "inches"`（默认）、`"points"` 或 `"EMU"`。1 英寸 = 914400 EMUs = 72 点。
</div>
### 谷歌表单（44 个工具）
| 工具 | 描述 |
|------|-------------|
| `create_form` | 创建新表单 |
| `copy_form` | 复制现有表单 |
| `delete_form` | 删除表单 |
| `get_form` | 获取完整表单详情 |
| `get_form_metadata` | 获取响应计数、修订版 |
| `update_form_settings` | 更新标题、描述、测验模式 |
| `set_publish_settings` | 发布/取消发布、接受响应 |
| `set_form_description` | 更新描述 |
| `list_forms` | 从 Drive 列出表单 |
| `add_text_question` | 简短答案文本 |
| `add_paragraph_question` | 长答案段落 |
| `add_multiple_choice_question` | 带选项的多项选择题 |
| `add_checkbox_question` | 复选框（多选） |
| `add_dropdown_question` | 带选项的下拉菜单 |
| `add_linear_scale_question` | 线性比例（1-5 等） |
| `add_date_question` | 日期问题 |
| `add_time_question` | 时间问题 |
| `add_rating_question` | 评分（星级、心形等） |
| `add_file_upload_question` | 文件上传 |
| `add_choice_grid` | 网格问题（行 x 列） |
| `add_page_break` | 添加分页符 |
| `add_section_header` | 添加章节标题 |
| `add_title_description` | 添加标题/描述块 |
| `add_image` | 添加图片（URL 或 Drive） |
| `add_video` | 添加 YouTube 视频 |
| `update_question` | 更新问题文本/选项 |
| `delete_question` | 删除问题 |
| `reorder_items` | 重新排序表单项 |
| `set_question_grading` | 设置分数值 + 正确答案 |
| `add_question_validation` | 添加正则表达式/数字/文本验证 |
| `add_question_option` | 添加问题选项 |
| `remove_question_option` | 删除选项 |
| `shuffle_question_options` | 启用/禁用选项洗牌 |
| `set_question_required` | 设置必填/可选 |
| `set_question_description` | 添加帮助文本 |
| `get_form_responses` | 获取所有响应 |
| `get_responses_sheet` | 获取链接的电子表格 URL |
| `get_form_responses_analytics` | 测验分析 + 统计数据 |
| `delete_all_responses` | 删除所有响应 |
| `delete_response` | 删除特定响应 |
| `share_form` | 通过电子邮件分享表单 |
| `get_form_url` | 获取查看/编辑/创建 URL |
| `watch_form_responses` | 轮询新响应 |
| `move_item` | 移动问题位置 |
**问题选项：** `options: ["红色", "蓝色", "绿色"]` 表示选择题。 使用 `required: true/false`。
### 谷歌课堂（45 个工具）
| 工具 | 描述 |
|------|-------------|
| `list_courses` | 列出课程（教师/学生过滤） |
| `get_course` | 获取课程详情 |
| `create_course` | 创建新课程 |
| `update_course` | 更新课程属性 |
| `delete_course` | 删除/归档课程 |
| `update_course_state` | 活跃、归档、已预配 |
| `list_announcements` | 列出公告 |
| `get_announcement` | 获取公告详情 |
| `create_announcement` | 创建公告 |
| `update_announcement` | 更新公告 |
| `delete_announcement` | 删除公告 |
| `list_coursework` | 列出课程作业项 |
| `get_coursework` | 获取课程作业详情 |
| `create_coursework` | 创建作业/测验/材料 |
| `update_coursework` | 更新课程作业 |
| `delete_coursework` | 删除课程作业 |
| `list_student_submissions` | 列出提交作业 |
| `get_student_submission` | 获取提交作业详情 |
| `submit_student_submission` | 提交作业 |
| `unsubmit_student_submission` | 取消提交（返回 NEW） |
| `add_student_submission_attachment` | 添加附件 |
| `modify_attachments` | 修改附件 |
| `return_student_submission` | 返回给学生并评分 |
| `reclaim_student_submission` | 教师重新认领 |
| `grade_student_submission` | 设置已分配/草稿分数 |
| `list_topics` | 列出主题 |
| `create_topic` | 创建主题 |
| `update_topic` | 更新主题名称 |
| `delete_topic` | 删除主题 |
| `list_invitations` | 列出待处理邀请 |
| `create_invitation` | 邀请学生/教师 |
| `accept_invitation` | 接受邀请 |
| `delete_invitation` | 撤销邀请 |
| `list_students` | 列出课程中的学生 |
| `enroll_student` | 注册学生 |
| `remove_student` | 删除学生 |
| `list_teachers` | 列出教师 |
| `add_teacher` | 添加教师 |
| `remove_teacher` | 删除教师 |
| `list_course_materials` | 列出材料 |
| `get_course_material` | 获取材料详情 |
| `list_guardians` | 列出监护人关系 |
| `get_guardian` | 获取监护人详情 |
| `create_guardian` | 创建监护人链接 |
| `delete_guardian` | 删除监护人 |
**课程状态：** `活跃`、`归档`、`已预配`、`已拒绝`
**提交状态：** `新建`、`已创建`、`已提交`、`已返回`、`被学生重新认领`
**角色：** `学生`、`教师`
### 谷歌会议（12 个工具）
| 工具 | 描述 |
|------|-------------|
| `create_meeting_space` | 创建会议 |
| `get_meeting_space` | 获取会议详情 |
| `list_meetings` | 从日历列出会议 |
| `delete_meeting_space` | 结束/删除会议 |
| `get_meeting_participants` | 列出参与者 |
| `list_meeting_records` | 列出录音/转录记录 |
| `get_meeting_record` | 获取会议记录 |
| `get_meeting_recording` | 获取录音信息 |
| `get_meeting_transcript` | 获取转录信息 |
| `create_meeting_event` | 创建日历事件 + 会议链接 |
| `get_meeting_from_event` | 从日历事件中提取会议 |
| `update_meeting_access` | 修改访问类型（开放、受信任、受限制） |
### 谷歌云盘标签（24 个工具）
| 工具 | 描述 |
|------|-------------|
| `list_drive_labels` | 列出所有标签 |
| `get_drive_label` | 获取标签详情 |
| `create_drive_label` | 创建新标签 |
| `update_drive_label` | 更新标签（标题、状态） |
| `delete_drive_label` | 删除标签 |
| `disable_drive_label` | 禁用标签（只读） |
| `enable_drive_label` | 启用标签 |
| `add_label_field` | 添加字段（文本、整数、选择、日期、用户、电子邮件） |
| `update_label_field` | 更新字段属性 |
| `delete_label_field` | 删除字段 |
| `add_label_field_option` | 添加选择选项 |
| `update_label_field_option` | 更新选项 |
| `delete_label_field_option` | 删除选项 |
| `reorder_label_field_options` | 重新排序选项 |
| `apply_label_to_file` | 将标签应用于文件 |
| `remove_label_from_file` | 从文件删除标签 |
| `update_label_values_on_file` | 更新已应用的标签值 |
| `list_file_labels` | 列出文件上的标签 |
| `get_file_label` | 获取文件上的特定标签 |
| `list_label_revisions` | 列出标签定义修订版 |
| `get_label_revision` | 获取特定修订版 |
| `disable_label_revision` | 禁用修订版 |
| `get_label_permissions` | 获取谁可以使用标签 |
| `update_label_permissions` | 更新权限 |
**字段类型：** `文本`（字符串）、`整数`（数字）、`选择`（选项）、`日期`（年/月/日）、`用户`（用户电子邮件）、`电子邮件`（电子邮件地址）。
## 快速工作流
### 分享文件
```
share_drive_file { fileId: "xxx", email: "user@example.com", role: "writer" }
```
### 创建带有会议链接的事件
```
create_event {
summary: "团队同步",
startDateTime: "2026-06-30T10:00:00Z",
endDateTime: "2026-06-30T10:30:00Z",
timeZone: "America/New_York",
attendees: ["alice@example.com"],
conferenceDataVersion: 1
}
```
### 写入电子表格
```
write_range {
spreadsheetId: "xxx",
range: "Sheet1!A1:C3",
values: [["姓名","分数"],["爱丽丝","95"],["鲍勃","87"]]
}
```
### 创建带有内容的文档
```
docs_create_document { title: "报告" }
→ docs_insert_text { documentId: "...", text: "介绍\n", index: 0 }
→ docs_insert_table { documentId: "...", rows: 3, columns: 2 }
```
### 构建表单
```
create_form { title: "反馈" }
→ add_text_question { formId: "...", title: "姓名", required: true }
→ add_multiple_choice_question { formId: "...", title: "评分", options: ["优秀","良好","一般"] }
```
### 课程 + 作业
```
create_course { name: "数学 101", section: "2026 秋季" }
→ create_coursework { courseId: "...", title: "作业 1", workType: "ASSIGNMENT", maxPoints: 100 }
```
### 将标签应用于文件
```
apply_label_to_file {
fileId: "xxx",
labelId: "yyy",
fieldValues: { "field1": "已批准", "field2": "2026-06-29" }
}
```
## 故障排除
### "服务器断开连接" 错误
- 检查您的配置中 `build/index.js` 的路径是否正确
- 检查 Node.js 是否已安装并在您的 PATH 中
### "谷歌 API 未被使用" 错误
在以下网址启用所需的 API：`https://console.cloud.google.com/apis/library/{api-name}`
安装程序将指导您启用所有必需的 API。
### "未找到 key.json" 错误
将下载的谷歌凭证文件 `key.json` 放在项目根目录中。
### "身份验证失败" 错误
服务器自动处理重新身份验证。如果失败：
1. 删除 `token.json`
2. 运行 `npm start` 或重启 Claude Desktop
### Token 过期 / 撤销
服务器会自动检测过期的 token 并打开浏览器进行重新身份验证。无需手动干预。
## 许可证
MIT
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器