Google Drive MCP：让 LLM 读写 Google Docs/Sheets/Drive 的官方服务器

简介

Google Drive MCP 是 ModelContextProtocol 官方仓库维护的云存储集成服务器。它把 Google Drive API 包装为 MCP 工具，让任何兼容 MCP 的客户端都能通过统一协议操作 Google Workspace，无需各自实现 OAuth 流程、无需维护 token 刷新、无需处理 API 限流。

对重度使用 Google 生态的用户而言，这意味着：让 AI 助理直接帮你"搜一下我 Drive 里去年的季度报告"、"读取那张 Sheets 的销售数据"、"把这段总结写入我的 Notes 文档"。

核心能力

工具名	用途	关键参数
`gdrive_search`	搜索文件与文件夹	`query`、`page_size`（默认 10）、`mime_type` 过滤
`gdrive_get_file`	读取文件内容（含 Docs/Sheets）	`file_id`
`gdrive_get_file_metadata`	获取文件元信息	`file_id`
`gdrive_create_file`	创建新文件	`name`、`content`、`mime_type`、`parent_id`
`gdrive_update_file`	更新已有文件内容	`file_id`、`content`
`gdrive_list_folder`	列出文件夹内容	`folder_id`、`page_size`
`gdrive_upload_file`	上传本地文件	`parent_id`、`filename`、`file_data`

支持的特殊 mime type：

application/vnd.google-apps.document（Google Docs）
application/vnd.google-apps.spreadsheet（Google Sheets）
application/vnd.google-apps.presentation（Google Slides）
application/pdf、text/plain、application/vnd.openxmlformats-officedocument.wordprocessingml.document（.docx）

申请 Google OAuth 凭证

步骤 1：创建 Google Cloud 项目

访问 https://console.cloud.google.com/
顶部选择项目 → 新建项目 → 命名（如 mcp-drive）

步骤 2：启用 Google Drive API

进入 APIs & Services → Library
搜索 Google Drive API → Enable

步骤 3：配置 OAuth 同意屏幕

进入 APIs & Services → OAuth consent screen
选择 External → 填写 App 名称、邮箱
在 Scopes 中添加：
- https://www.googleapis.com/auth/drive.file（推荐：仅访问应用创建或打开的文件）
- https://www.googleapis.com/auth/drive.metadata.readonly（读取文件元信息）
- 如需全量访问：https://www.googleapis.com/auth/drive（敏感权限需审核）
添加测试用户：填入你的 Google 账号邮箱

步骤 4：创建 OAuth 客户端凭证

进入 APIs & Services → Credentials → Create Credentials → OAuth client ID
选择 Desktop app（MCP 是本地进程，不是 Web 服务）
创建后下载 JSON 文件，重命名为 gdrive-oauth-credentials.json

步骤 5：首次运行完成 OAuth 授权

首次启动 MCP 服务器会触发 OAuth 流程：

控制台打印授权 URL
浏览器打开 → 用 Google 账号登录 → 同意
返回的 code 自动写入 ~/.mcp/gdrive-oauth-token.json
后续运行自动复用 token，过期自动刷新

各客户端配置示例

Claude Code（CLI）

编辑 ~/.claude/claude_desktop_config.json：

{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-google-drive"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS_PATH": "/path/to/gdrive-oauth-credentials.json"
      }
    }
  }
}

首次启动后浏览器会弹出授权页，授权完成后即可使用。

Cursor

编辑 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-google-drive"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS_PATH": "/path/to/gdrive-oauth-credentials.json"
      }
    }
  }
}

VS Code（Continue 插件）

编辑 ~/.continue/config.json：

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "@modelcontextprotocol/server-google-drive"]
        },
        "env": {
          "GOOGLE_OAUTH_CREDENTIALS_PATH": "/path/to/gdrive-oauth-credentials.json"
        }
      }
    ]
  }
}

Cline 插件

通过 Cline: MCP Settings 命令打开 cline_mcp_settings.json，结构与 Claude Desktop 一致。

实战场景

场景 1：让 Claude Code 做"会议纪要助理"

读取我 Drive 里标题包含「2026 Q3 产品评审」的 Google Doc，
提取所有 action item，
新建一个 Google Sheet 记录这些 item，列：任务 / 负责人 / 截止日期。

Claude Code 会调用 gdrive_search → gdrive_get_file（Doc）→ 解析 → gdrive_create_file（Sheet）。

场景 2：让 Cursor 做"季度报告生成器"

搜索我 Drive 里 2026 年 Q2 的所有 Google Sheets（按文件名匹配 "2026-Q2-*"），
读取每个 Sheet 的第一个工作表，
汇总成一份 Markdown 报告，保存为新 Google Doc。

配合 Cursor 的代码执行能力，可批量处理多个 Sheet。

场景 3：让 VS Code 做"技术文档归档员"

读取当前工作区的 README.md 和 docs/ 目录下所有 .md 文件，
分别上传到我 Drive 的「项目文档」文件夹，
文件名保持原名。

Cline + Continue 可循环调用 gdrive_upload_file 完成批量上传。

场景 4：跨文档信息检索

搜索我 Drive 里所有 Google Docs，
找出提到「OKR」的文档，
整理成表格：文件名 / 修改时间 / 上下文片段。

gdrive_search 支持完整 Google Drive 搜索语法（title:、type:、owner:、before:、after:）。

与本地 Filesystem MCP 的对比

维度	Google Drive MCP	Filesystem MCP
存储位置	云端	本地磁盘
跨设备访问	✅	❌
协作能力	✅ 多人共享	❌
离线可用	❌	✅
大文件处理	慢（受 API 限流）	快
OAuth 复杂度	高（需配置凭证）	无
适用场景	文档协作、跨设备	代码工程、本地脚本

建议两者都装：Filesystem MCP 管代码与脚本，Google Drive MCP 管文档与协作。

注意事项

凭证保密：gdrive-oauth-credentials.json 和 gdrive-oauth-token.json 切勿提交到 Git。前者含 client secret，后者含 refresh token，泄露后他人可冒充你访问 Drive。
Scope 选择：优先用 drive.file（仅应用创建/打开的文件），避免申请 drive（全量访问）触发 Google 审核。
Quota 限制：Google Drive API 默认每天 1,000,000,000 次查询，但每秒每用户 1000 次。MCP 服务器已内置退避，但仍建议避免循环调用。
OAuth Token 过期：refresh token 默认 7 天过期（测试用户），生产应用需通过 Google 审核。token 过期后需重新授权。
大文件读取：gdrive_get_file 对超过 10MB 的文件会截断，建议用 gdrive_get_file_metadata 先判断大小。
Sheets 特殊处理：Google Sheets 返回的是 JSON（网格数据），不是 CSV。MCP 服务器已自动转 Markdown 表格，但复杂公式可能丢失。
共享驱动器：My Drive 与 Shared Drive 的 API 行为略有差异，搜索时需用 includeItemsFromAllDrives: true。
中文文件名：Google Drive API 完全支持 UTF-8，但 Windows 上 MCP 客户端可能有编码问题，建议终端设为 UTF-8。

安全建议

最小权限原则：只申请实际需要的 Scope，优先 drive.file 而非 drive
文件夹白名单：在 Prompt 中限定 AI 只能操作特定文件夹，防止误删
操作审计：让 AI 在每次创建/更新文件前先在本地日志记录
测试用户：开发期用测试账号，不要用主账号授权
凭证轮换：每 90 天在 Google Cloud Console 重新生成 OAuth 凭证

小结

Google Drive MCP 是 Google Workspace 用户最直接的 AI 文档入口：一次 OAuth 授权、一份凭证文件，就能让任意 MCP 客户端读写 Drive。对于需要"搜索文档、读取内容、创建报告、上传文件"的办公场景，几乎是必装组件。建议搭配 Filesystem MCP（管理本地代码）和 Slack MCP（消息协同）组成企业办公三件套。

下一篇我们会讲 Notion MCP，看如何让 LLM 读写 Notion 数据库与页面。