Google Drive MCP Server (Official)

什么是 Google Drive MCP Server (Official)？

Google Drive MCP Server (Official) 是 Google 托管的 Google Drive MCP 服务器，地址为 https://drivemcp.googleapis.com/mcp/v1。它让 AI 智能体以你自己的权限搜索、读取、创建、复制和下载 Drive 文件。目前处于 Developer Preview 阶段。

这是一个远程服务器，本地无需运行任何程序，使用 Streamable HTTP 协议和 OAuth 2.0 认证。目前需要加入 Google Workspace Developer Preview Program 才能使用。配置方法和工具列表见 Google 的指南 Configure the Drive MCP server。较早的开源参考服务器仍以 Google Drive MCP Server 收录在 mcp.so 上，但已归档。

如何使用 Google Drive MCP Server (Official)？

前提条件：已加入 Developer Preview，有一个 Google Cloud 项目；如果要运行下面的命令，还需要 gcloud CLI。不需要 API Key，认证使用你创建的 OAuth 客户端。

1. 在项目中启用 Drive API 和 Drive MCP 服务：

gcloud services enable drive.googleapis.com --project=PROJECT_ID
gcloud services enable drivemcp.googleapis.com --project=PROJECT_ID

2. 在 Google Auth Platform > Branding 中配置 OAuth 同意屏幕。能选 Internal 就选 Internal；否则选 External，并把自己加为测试用户。在 Data Access 中添加以下 scope：

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive.file

3. 在 Google Auth Platform > Clients > Create Client 中创建 OAuth 客户端：类型选 Web application，添加对应客户端的重定向 URI（见下文），并勾选 Use this client for an AI-powered agent。然后复制客户端 ID 和密钥。

Claude Desktop

Claude.ai 和 Claude Desktop 的自定义连接器需要 Pro、Max、Team 或 Enterprise 套餐。OAuth 重定向 URI 使用 https://claude.ai/api/mcp/auth_callback。然后进入 Settings（或 Admin settings）> Connectors > Add custom connector，填写：

• Server name：Google Drive
• Remote MCP server URL：https://drivemcp.googleapis.com/mcp/v1
• Advanced settings：你的 OAuth 客户端 ID 和客户端密钥

Antigravity

重定向 URI 使用 https://antigravity.google/oauth-callback。把以下内容添加到 ~/.gemini/config/mcp_config.json，然后打开 MCP 设置（Antigravity CLI 中使用 /mcp）并选择 Authenticate：

{
  "mcpServers": {
    "drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "${OAUTH_CLIENT_ID}",
        "clientSecret": "${OAUTH_CLIENT_SECRET}"
      }
    }
  }
}

其他客户端（Claude Code、Cursor、VS Code）

Google 没有为这些客户端提供专门的步骤。它的通用参数适用于任何支持 OAuth 远程服务器的客户端：服务器名 drive，URL https://drivemcp.googleapis.com/mcp/v1，传输方式 Streamable HTTP，认证方式 OAuth 2.0。客户端必须能使用你预先创建的客户端 ID 和密钥，并且要把该客户端自己的回调 URL 注册为重定向 URI。

测试连接时可以提问：“Summarize the file Marketing Plan.” 客户端应先调用 search_files，再调用 read_file_content。

Google Drive MCP Server (Official) 的主要功能

• 由 Google 运营，无需安装、托管或更新
• 远程 Streamable HTTP 端点，使用 OAuth 2.0 认证
• 沿用登录用户原有的权限和数据治理控制
• 支持在 Drive 中进行全文和结构化搜索，并能列出最近的文件
• 以自然语言文本读取 Docs、Sheets 等文件，可选包含评论
• 可创建文件和文件夹（包括 Google Docs、Sheets 和 Slides）、上传内容、复制文件
• OAuth scope 范围很窄：drive.readonly 加 drive.file
• 没有删除、移入回收站或共享文件的工具

Google Drive MCP Server (Official) 工具

服务器在唯一的 /mcp/v1 工具集中提供八个工具。

• 查找文件：search_files 执行结构化查询，例如按标题、全文或 MIME 类型；list_recent_files 可按最近活动、最后修改时间或你本人最后修改时间排序。
• 读取文件：read_file_content 返回文件的文本形式，可附带评论；download_file_content 以 base64 返回原始内容，Google 文件可指定导出 MIME 类型；get_file_metadata 和 get_file_permissions 显示文件详情和访问权限。
• 写入文件：create_file 创建或上传文件和文件夹；copy_file 复制文件，可指定新标题和父文件夹。

Google Drive MCP Server (Official) 的使用场景

• 总结文档：“总结 Marketing Plan 文件并列出待解决的问题。”
• 查找信息：“找出我这周编辑过的有关 Q3 预算的表格。”
• 在 Drive 中起草：“在我的 Projects 文件夹里新建一个名为 Meeting Notes 的 Google Doc，写入这些要点。”
• 使用模板：“复制 Proposal Template，并命名为 Acme Proposal。”
• 权限检查：“谁有 Roadmap 文件的访问权限？”
• 智能体流程：智能体可以把 Drive 内容提供给其他工具，每一步操作都由你审核。

Google Drive MCP Server (Official) 与替代方案对比

已归档的参考版 Google Drive MCP Server 在本地运行，只读（只有一个 search 工具），npm 包已弃用。Google Workspace MCP 等社区服务器除 Drive 外还覆盖 Gmail、Calendar、Docs 和 Sheets，而且不需要加入 Developer Preview，但需要自行托管，由第三方维护。如果你能加入预览计划，官方 Google Drive MCP 服务器是一个有官方支持的托管选择。

Google Drive MCP Server (Official) 常见问题排查

• 请求被拒绝：OAuth 客户端必须勾选 Use this client for an AI-powered agent。如果现有客户端无法修改这一项，就单独为智能体新建一个客户端。
• 大约每小时都要重新登录：客户端没有拿到 refresh token。如果客户端支持自定义授权参数，在授权请求中添加 access_type=offline（要重新获取时再加 prompt=consent）。
• 连接出错：请管理员在安全调查工具中查看 OAuth 日志事件。
• 找不到服务或访问被拒：确认已启用 drivemcp.googleapis.com 和 drive.googleapis.com，并且你的账号已加入 Developer Preview Program。