为什么需要 Google Drive MCP
云盘文件管理的痛点：
你：帮我找上季度所有合同，提取金额
传统流程：
1. 打开 Google Drive
2. 搜"合同" → 50 个文件
3. 一个个打开读
4. 复制金额到表格
5. 切回 AI 对话，贴数据
→ 50 次点击，2 小时
Google Drive MCP：
你：找上季度合同，提取金额做汇总
AI：
1. 搜索 q3 合同（Drive API）
2. 逐个读取内容
3. 提取金额字段
4. 生成汇总表
5. 存到新 Google Sheet
→ 1 步，0 次切换
Google Drive MCP 把云盘从"手动翻找"变成 AI 的原生数据源。
核心能力
| 工具 | 说明 |
|---|---|
| 搜索文件 | 按关键词/类型/时间搜 Drive |
| 读取文件 | 读 Google Docs/Sheets/Slides 内容 |
| 创建文件 | 新建 Docs/Sheets/文件夹 |
| 写入文件 | 改内容、追加段落 |
| 上传文件 | 本地文件传到 Drive |
| 列出文件夹 | 查指定文件夹下的文件 |
安装与配置
Step 1：创建 Google Cloud 项目
- 访问 https://console.cloud.google.com
- 新建项目（如
mcp-drive） - 启用 Google Drive API
- 创建 OAuth 2.0 凭证（桌面应用类型）
- 下载
credentials.json
Step 2：首次授权
# 跑一次授权流程，生成 token
npx @modelcontextprotocol/server-google-drive auth
# → 浏览器打开 → 授权 → 生成 token.json
Step 3：各客户端配置
Claude Desktop
{
"mcpServers": {
"google-drive": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-google-drive"],
"env": {
"GOOGLE_DRIVE_CREDENTIALS_PATH": "/path/to/credentials.json",
"GOOGLE_DRIVE_TOKEN_PATH": "/path/to/token.json"
}
}
}
}
Cursor / VS Code Continue
{
"mcpServers": {
"google-drive": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-google-drive"],
"env": {
"GOOGLE_DRIVE_CREDENTIALS_PATH": "/path/to/credentials.json",
"GOOGLE_DRIVE_TOKEN_PATH": "/path/to/token.json"
}
}
}
}
Step 4：验证
列出"工作"文件夹下的所有文件
AI 返回文件清单，确认配置成功。
五个实战场景
场景 1：跨文档检索
你：找所有提到"RAG"的文档，列出标题和要点
AI：
1. 搜索 q="RAG" → 12 个文件
2. 逐个读内容，判断是否真相关
3. 命中 8 个
4. 每个提取标题 + 要点
5. 输出汇总表：
| 文档 | 要点 | 修改时间 |
场景 2：会议纪要归档
配合录音转文字：
你：这是会议录音转写，整理成纪要存到"会议记录"文件夹
AI：
1. 提炼：主题/时间/参会人/决议/待办
2. 在"会议记录"文件夹建 Google Doc
3. 标题：[日期] 主题
4. 写入整理好的内容
5. 设置共享给参会人
场景 3：批量整理
你：把"待整理"文件夹 30 个文档按主题归档
AI：
1. 列出待整理文件
2. 读每个内容，判断主题
3. 分 5 个主题
4. 建对应文件夹
5. 移文件到对应文件夹
→ 30 个 1 分钟归档
场景 4：合同金额提取
你：找 Q3 合同，提取金额做汇总
AI：
1. 搜索 folder="合同" and time=Q3 → 20 个 Doc
2. 逐个读，正则 + LLM 提取"金额"字段
3. 生成 Google Sheet：
| 合同号 | 甲方 | 金额 | 签订日 |
4. 存到"财务汇总"文件夹
场景 5：协作分发
你：把这份报告发给 5 个部门的负责人
AI：
1. 读报告内容
2. 为每个部门生成定制摘要（去无关部分）
3. 建 5 个 Google Doc，共享给对应人
4. 发邮件通知（配 SMTP）
权限管控要点
1. 只读优先
日常检索用只读 OAuth scope
写操作用独立凭证 + 二次确认
OAuth scope 选择：
drive.metadata.readonly：只读元数据（最安全）drive.readonly：只读内容drive：读写（高风险，慎用）
2. 文件夹隔离
✗ 给 MCP 整个 Drive 访问权 → 风险大
✓ 建专用 Service Account，只共享特定文件夹
例：只共享"工作"文件夹给 mcp-bot
3. 敏感文件隔离
✗ 财务/合同/人事文件夹也授权 → AI 可能泄露
✓ 敏感文件夹不共享给 MCP 账号
4. 写操作 system prompt 规则
你连的是生产 Drive。规则：
1. 创建文件前确认标题与父文件夹
2. 不删除已有文件（移到"回收站"文件夹）
3. 修改共享文件前提示用户
4. 大批量操作（>10 个）需用户确认
注意事项
1. API 配额
Google Drive API 限速约 1000 请求/100 秒。批量操作加 sleep：
import time
for file in files:
drive.read(file["id"])
time.sleep(0.1) # 避免限流
2. 文件类型适配
Google Docs：可读纯文本
Google Sheets：读单元格（需指定 range）
Google Slides：读页文本
PDF/Word：需下载转文本
图片：需 OCR
3. 搜索局限
Drive 搜索是关键词匹配，非语义
→ 换同义词可能搜不到
→ 配合 [Notion MCP](/mcp/2026-08-17-notion-mcp) 做结构化知识检索
4. 共享权限继承
MCP 账号建的文件，默认共享给 MCP 账号
→ 团队成员看不到
→ 建文件时显式设置共享权限
5. token 过期
OAuth token 有效期约 1 小时
→ server 自动刷新（refresh_token）
→ refresh_token 过期需重新授权
与其他 MCP 的协作
| 组合 | 场景 |
|---|---|
| Drive + Notion | Drive 文档结构化到 Notion |
| Drive + Filesystem | 本地文件 ↔ 云盘同步 |
| Drive + Slack | Drive 文件变更通知团队 |
| Drive + Postgres | 提取数据入库分析 |
与 Filesystem MCP 的区别
| 维度 | Google Drive MCP | Filesystem MCP |
|---|---|---|
| 存储 | 云端 | 本地 |
| 协作 | 多人实时 | 需额外同步 |
| 搜索 | Drive API（关键词） | 本地 grep |
| 离线 | 不支持 | 支持 |
| 适合 | 团队协作文档 | 本地代码/配置 |
与 Notion MCP 的区别
| 维度 | Google Drive MCP | Notion MCP |
|---|---|---|
| 结构 | 文件（Doc/Sheet/Slide） | 数据库 + 页面（结构化） |
| 检索 | 关键词 | 关键词（Q&A 模式更强） |
| 关系 | 弱 | 强（数据库关联） |
| 适合 | 文档管理 | 知识库 |
文件存储三件套
Filesystem MCP（本地） → 开发/代码
Google Drive MCP（云端文档） → 协作/分享
Notion MCP（结构化知识） → 管理/检索
三者覆盖了从本地到云端、从文件到知识、从个人到团队的全场景。
小结
Google Drive MCP 把云盘从"需要手动翻找、手动整理"变成 AI 的原生数据源。
记住一个原则：只读 scope 日常用，写操作用独立凭证 + 二次确认。配合 Filesystem MCP（本地）、Notion MCP（结构化），文件存储三件套集齐——从本地到云端、从文件到知识，AI 都能原生读写。