Google Drive MCP

Google Drive MCP

英语 | 俄语

A1 Google Drive MCP 让 AI 应用能够通过自然语言操作你的 Google Drive。查找文件、整理文件夹、上传和下载内容、将文档导出为 Markdown、与合适的人共享——并确保文件先进入回收站，而不是直接永久删除。

它使用你的 Google 账号调用 Google Drive API。它能够访问“我的云端硬盘”和共享云端硬盘；将“删除”视为可撤销的移至回收站操作；并明确说明 Drive API 的限制，而不会暗示所有文件操作都能实现。

• 21 个工具。 搜索和元数据、文件夹和移动、上传和下载、导出 Docs/Sheets/Slides、回收站、共享和评论。
• 在对话中连接。 说“连接 Google Drive”：服务会引导你设置 OAuth 客户端，通过 PKCE 在 127.0.0.1 捕获 Google 的重定向，并自行保管令牌——无需配置文件，也无需重启。
• 优先使用回收站。 “删除”意味着移至可撤销的回收站；永久删除则由一个独立的工具执行，不会误选。
• 文档保持完整。 Docs、Sheets 和 Slides 会作为完整文件移动、复制、导出和转换——服务绝不会修改其中的文本。
• 由你选择权限范围。 drive.readonly 涵盖所有读取操作，drive.file 将访问权限限制在应用创建的文件；完整的工具功能需要 drive。

先从只读问题开始：

在我的 Drive 中查找项目路线图文档，将其导出为 Markdown 并进行总结。

连接服务 · 探索使用场景 · 查看技术文档

一分钟了解它的工作方式

你： 显示“Contracts 2025”文件夹中的内容，按最新优先排序。

助手： 列出文件及其类型、所有者和修改日期。不会更改任何内容。

你： 创建一个“Archive”子文件夹，并将所有一年以上的内容移进去。

助手： 显示将要创建的文件夹和要移动的文件，然后请求确认。

你： 确认。

助手： 创建文件夹并移动文件。除非你另行要求，否则不会共享、移至回收站或删除任何内容。

目录

• 快速开始
• 你可以让它做什么
• Drive 的变更方式
• 哪些内容可以更改
• 获取访问权限
• 配置
• 数据、限制和后台工作
• 技术文档
• 支持

快速开始

你需要 Node.js 20+ 和一个 Google 账号。安装时无需凭据——服务会在对话过程中连接。

1. 将服务添加到你的 AI 应用。
2. 说“连接 Google Drive”：助手会引导你创建 OAuth 客户端并批准访问，无需编辑配置文件。
3. 提出上面的只读问题。

codex mcp add google-drive \
  -- npx -y @a1-x-tech/mcp-google-drive@latest

codex mcp list

claude mcp add \
  --transport stdio --scope user google-drive \
  -- npx -y @a1-x-tech/mcp-google-drive@latest

claude mcp list

{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-drive@latest"]
    }
  }
}

{
  "mcpServers": {
    "google-drive": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-drive@latest"]
    }
  }
}

{
  "servers": {
    "google-drive": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-drive@latest"]
    }
  }
}

可以让它做什么

查找和读取文件

• 找到上一季度的预算电子表格，并显示其位置和所有者。
• 将项目简介导出为 Markdown，并总结尚未解决的问题。
• 将已签署的合同 PDF 下载到我的报告文件夹。

整理和传输内容

• 创建一个“2026 报告”文件夹，并将月度报告移入其中。
• 上传这些会议记录，并将其转换为 Google 文档。
• 复制提案模板，并将副本重命名为新客户的名称。

分享和讨论

• 将文件夹分享给一位队友，授予其评论者权限，并在邀请中添加备注。
• 列出设计文档中尚未解决的评论，并解决已处理的评论。
• 撤销外部承包商对档案的访问权限。

谨慎清理

• 将过时的草稿移至回收站，并恢复误删的那份。
• 在我确认后，永久删除包含测试上传内容的文件夹。
• 在清空回收站之前，先显示其中的内容。

Drive 中的更改方式

1. Drive 中的所有内容——包括文件夹和共享云端硬盘中的项目——都是带有 ID 的文件。名称并不唯一，因此工具会通过 ID 操作，允许存在重名：创建前最好先搜索。
2. “删除”指移入回收站：可撤销，Google 会在约 30 天后自动清空。永久删除会绕过回收站，同时删除整个文件夹子树，并由一个刻意单独设置的工具执行。
3. Google Docs、Sheets 和 Slides 会作为整体移动、复制、共享、导出和转换。此服务没有用于编辑 Doc 内文本或 Sheet 内单元格的工具。
4. 写入操作在失败情况不确定时绝不会重放：网络错误和 5xx 错误后的重试仅适用于读取，因此复制、上传或新建文件夹不会在你不知情的情况下重复执行。

内置上传上限为 5 MB（更大的文件需通过 raw_request 使用可恢复会话），根据 Drive API，导出上限为 10 MB。通过 API 创建的评论无法锚定到 Doc 内的特定段落。

可以更改的内容

AI 客户端控制确认提示。此服务会标记读取、写入和破坏性工具，以便客户端区分检查操作和实际更改。

获取访问权限

Google Drive 需要 OAuth 2.0；仅有 API 密钥还不够。有两种接入方式，第一种无需配置文件。

从聊天中连接（推荐）

说“connect Google Drive”，助手就会引导你完成流程：

1. setup_instructions 会打印检查清单：创建或选择 Google Cloud 项目、启用 Google Drive API、配置同意屏幕，并创建 Desktop app OAuth 客户端。
2. 下载该客户端的 JSON（“Download JSON”），并将其路径提供给助手——set_client 会以仅所有者可访问的方式保存该文件。密钥绝不会经过对话传递。
3. start_login 会返回 Google 授权链接。在这台机器上打开链接并批准；授权码会通过 PKCE 返回到 127.0.0.1 上的一次性监听器，绝不会经过聊天传递。
4. finish_login 会交换授权码，并将令牌保存到 ~/.config/mcp-google-drive/credentials.json（mode 0600），然后通过一次真实的 Google Drive API 调用验证令牌——如果 API 仍处于关闭状态，会在此处立即发现。

每次调用都会重新读取令牌，因此连接会立即生效——无需重启 AI 应用。auth_status 会显示已连接的内容，logout 会撤销并删除连接。

环境变量（CI、无人值守安装）

1. 创建或选择一个 Google Cloud 项目，并启用 Google Drive API。

2. 配置 OAuth 同意屏幕，并创建 Desktop app OAuth 客户端。

3. 授权服务器应操作其文件的 Google 账号。启用 Use your own OAuth credentials 后，可通过 OAuth 2.0 Playground 获取刷新令牌。

4. 请求能够满足用途的最小权限范围：

   权限范围	可用功能
   https://www.googleapis.com/auth/drive.readonly	只读工具：搜索、元数据、下载、导出和共享云端硬盘列表。
   https://www.googleapis.com/auth/drive.file	仅限此应用创建或打开的文件——足以支持对应用拥有的文件进行上传和整理。
   https://www.googleapis.com/auth/drive	所有工具功能：共享、移至回收站、删除以及对任意文件发表评论。

服务器使用刷新令牌签发时所包含的权限范围；超出该范围的调用会失败，并返回 insufficientPermissions 错误。

测试模式下的 OAuth 刷新令牌可能会在 7 天后过期。如需长期访问，请发布 OAuth 应用，或在 Workspace 网域中使用 Internal 应用。请将客户端密钥和刷新令牌视同密码妥善保管。

配置

所有变量均为可选项——不设置任何变量时，服务器会从聊天中连接。

* 提供 OAuth 三项配置或访问令牌之一。

即使没有任何凭据，服务器仍会启动并完成 MCP 握手；首次调用工具时，它会回复需要设置的准确变量，而不会导致服务器无法使用。

数据、限制和后台工作

• 请求会发送到 Google Drive。 本地服务器会刷新 Google OAuth 令牌并调用 Drive API。匿名遥测包含安装 ID、软件包版本、AI 客户端和平台版本以及工具名称——绝不包含 OAuth 令牌、文件内容、工具参数或提示词。设置 ASKADS_TELEMETRY=0 可选择退出。
• Google 会实施配额和大小限制。 通过内置工具上传的文件最大为 5 MB，导出的文件最大为 10 MB。遇到 429 时，服务器会采用退避策略；读取操作在网络错误和 5xx 错误后也会重试，而写入操作在结果不确定的失败后不会重放。
• 谨慎处理本地文件。 下载只会保存到绝对路径，且除非收到指示，否则不会覆盖现有文件；内联返回的文本内容上限为 100 KB。
• 没有后台轮询。 服务器仅在被调用时运行；它不会在请求间隔监视你的 Drive。如果你的 AI 应用支持计划任务，可以定期检查变更。

技术文档

• MCP 功能目录 — 面向任务的页面，介绍每个工具。
• 所有工具和输入
• 开发文档
• 发布文档
• Google Drive API 参考

支持

发现了 Bug 或需要某个场景？创建问题 或在 Telegram 上留言。

你已经读到最后了！