← 返回目录

Google Drive MCP Server

社区

已归档

搜索并读取云端文档与表格

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 云存储第 10 / 15
Stars: ★ 305 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 16 个月前 ⚠
工具数: 4

55FMRS · C

云端文档检索价值明确，但 OAuth 配置和文档暴露范围需要严格控制；社区维护状态与真实授权流程仍待运行验证。

最强项 · 可靠性 13/20 最弱项 · 维护活跃度 9/20

可靠性

13/20

安全与权限

11/20

维护活跃度

9/20

文档质量

12/20

安装易用性

10/20

已人工审核收录于 2026-07-13

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件访问网络

适合谁

需要让助手检索 Google Drive 文档和表格的个人或团队
希望用云端文档作为问答上下文的知识工作流

不适合谁

不能让模型处理 Drive 文档内容的高敏感组织
需要完整编辑、共享或删除 Drive 文件的管理场景

所需权限

Google Cloud OAuth 客户端凭据
对目标 Drive 文件的读取权限及相应只读 OAuth Scope

风险与副作用

搜索结果和文档正文可能包含个人、客户或内部数据
授权范围过宽会让助手发现原本不需要访问的文件

安装接入

准备工作

运行环境：Node.js

GDRIVE_CREDENTIALS_PATH 必填密钥指向 Google OAuth 凭据文件（如 ./credentials.）的路径，需在 Google Cloud Console 创建 OAuth 客户端后下载获得。

在 Google Cloud Console 创建 OAuth 凭据，下载 credentials.json 并完成一次授权。

claude_desktop_config.json

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-gdrive"],
      "env": {
        "GDRIVE_CREDENTIALS_PATH": "./credentials.json"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "gdrive": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gdrive"
      ],
      "env": {
        "GDRIVE_CREDENTIALS_PATH": "./credentials.json"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add gdrive -e GDRIVE_CREDENTIALS_PATH=./credentials.json -- npx -y @modelcontextprotocol/server-gdrive

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端的工具列表中应出现 search_files、read_file、list_files、export_document 四个工具；运行一次 list_files 能返回 Drive 文件即说明 OAuth 凭据配置成功。

常见排障

确认 Google Cloud 项目已启用所需 API
检查 OAuth consent screen 和测试用户设置
删除旧 Token 后重新授权以应用更新后的 Scope

试试这样问

连接成功后，可以直接对 AI 助手这样说：

在我的 Google Drive 中搜索包含项目计划的文件
列出我 Drive 中最近的文件
读取文件 "会议记录" 的内容
把这份 Google Docs 文档导出为文本

工具能力 4

search_files 只读

在云盘中全文搜索文件

read_file 只读

读取文档或表格内容

list_files 只读

列出目录下的文件

export_document 只读

导出为其他格式

使用场景

快速检索团队历史文档

汇总多份表格中的数据

让助手引用云端资料回答问题

支持客户端

Claude Desktop

Cursor部分支持

依据项目文档列出，未经本站实测。

详细介绍

通过 OAuth 授权访问 Google Drive，支持全文搜索、读取 Docs/Sheets 内容，把云端资料纳入对话上下文，由社区维护。

同仓库的其他 Server

源版本 9be4674d1ddf 数据同步于 2026-10-14 查看 FMRS 评分方法