如何设置 Google Drive MCP Server (2026)

如何在 2026 年设置 Google Drive MCP 服务器

如果你的文档、规格说明或参考资料存储在 Google Drive 中，通过 MCP（Model Context Protocol）将其连接到你的 AI 编程助手，意味着 AI 可以直接读取这些文档，而无需你来回复制粘贴内容。本指南将介绍如何设置 Google Drive MCP 服务器、配置身份验证，并将其连接到 Claude Desktop、Claude Code、Cursor 以及其他兼容 MCP 的工具。

你能用 Google Drive MCP 做什么

连接后，你的 AI 助手可以：

按名称或内容搜索你的 Google Drive 文件
读取 Google Docs、Sheets、Slides 以及上传的文件（PDF、文本文件、图像）
列出特定文件夹中的文件
从 Google Sheets 读取电子表格数据进行分析
访问共享云端硬盘和团队文件夹

实际应用场景

应用场景	示例
根据规格说明编写代码	"读取我们共享云端硬盘中的 API 规格说明并生成 TypeScript 类型"
数据分析	"从 Google Sheet 中提取第四季度指标并总结趋势"
文档编写	"检查 Drive 中的样式指南并重写此组件文档"
会议纪要	"阅读昨天的站会笔记并创建 Jira 工单"
设计审查	"阅读产品需求文档并与我的实现进行对比"

前提条件

在开始之前，你需要：

一个 Google Cloud Platform 账号（免费层级即可）
一个具有 Drive 访问权限的 Google Workspace 或个人 Gmail 账号
已安装 Node.js 18+
一个兼容 MCP 的 AI 客户端（Claude Desktop、Claude Code、Cursor 等）

第 1 步：创建 Google Cloud 项目

前往 Google Cloud Console
点击顶部的 Select a project（选择项目），然后点击 New Project（新建项目）
命名为类似 mcp-drive-server 的名称
点击 Create（创建）

第 2 步：启用 Google Drive API

在新项目中，前往 APIs & Services > Library
搜索 "Google Drive API"
点击进入并点击 Enable（启用）
如果你需要访问电子表格，还请搜索并启用 "Google Sheets API"

第 3 步：创建 OAuth 2.0 凭据

MCP 服务器需要 OAuth 凭据才能代表你访问 Drive。

前往 APIs & Services > Credentials
点击 Create Credentials > OAuth client ID
如果系统提示，请先配置 OAuth 同意屏幕（Consent Screen）：
- 选择 External（外部，如果你有 Workspace 则选 Internal）
- 填写应用名称：MCP Drive Server
- 添加你的电子邮件作为测试用户
- 同意屏幕上无需添加范围（Scopes）（它们会在运行时请求）
回到凭据页面，选择 Desktop app（桌面应用）作为应用类型
命名为 MCP Drive Server
点击 Create（创建）
下载 JSON 文件并将其保存为 gcp-oauth.keys.json

# 将下载的文件移动到安全位置
mkdir -p ~/.config/mcp
mv ~/Downloads/client_secret_*.json ~/.config/mcp/gcp-oauth.keys.json

第 4 步：安装 Google Drive MCP 服务器

安装官方 Google Drive MCP 服务器：

npm install -g @anthropic/mcp-server-gdrive

或者通过 npx 使用（无需安装）：

npx -y @anthropic/mcp-server-gdrive

第 5 步：进行 Google 身份验证

第一次运行服务器时，它需要完成 OAuth 流程以获取对 Google Drive 的访问权限。

# 运行身份验证流程
npx -y @anthropic/mcp-server-gdrive auth --keys-file ~/.config/mcp/gcp-oauth.keys.json

这将：

在浏览器中打开 Google 登录页面
请求你授予 MCP 服务器访问 Drive 的权限
在本地保存刷新令牌以供将来使用

令牌存储在 ~/.config/mcp/gdrive-credentials.json。请妥善保管此文件。

# 验证令牌是否已保存
ls -la ~/.config/mcp/gdrive-credentials.json

第 6 步：连接到你的 AI 客户端

Claude Desktop

编辑你的 Claude Desktop 配置文件：

# macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Windows
code %APPDATA%\Claude\claude_desktop_config.json

添加 Google Drive 服务器配置：

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-gdrive"],
      "env": {
        "GDRIVE_OAUTH_KEYS_FILE": "/Users/yourname/.config/mcp/gcp-oauth.keys.json",
        "GDRIVE_CREDENTIALS_FILE": "/Users/yourname/.config/mcp/gdrive-credentials.json"
      }
    }
  }
}

重启 Claude Desktop。你应该能在工具菜单（锤子图标）中看到可用的 Google Drive 工具。

Claude Code (CLI)

将 MCP 服务器添加到你的 Claude Code 配置中：

claude mcp add gdrive \
  --command "npx" \
  --args "-y" "@anthropic/mcp-server-gdrive" \
  --env "GDRIVE_OAUTH_KEYS_FILE=/Users/yourname/.config/mcp/gcp-oauth.keys.json" \
  --env "GDRIVE_CREDENTIALS_FILE=/Users/yourname/.config/mcp/gdrive-credentials.json"

或者直接编辑配置文件 ~/.claude/mcp.json：

{
  "servers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-gdrive"],
      "env": {
        "GDRIVE_OAUTH_KEYS_FILE": "/Users/yourname/.config/mcp/gcp-oauth.keys.json",
        "GDRIVE_CREDENTIALS_FILE": "/Users/yourname/.config/mcp/gdrive-credentials.json"
      }
    }
  }
}

Cursor

在 Cursor 的设置中添加 MCP 服务器：

打开 Settings (Cmd+,)
搜索 "MCP"
点击 Edit in settings.json 或导航至 MCP 配置
添加 Google Drive 服务器：

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-gdrive"],
      "env": {
        "GDRIVE_OAUTH_KEYS_FILE": "/Users/yourname/.config/mcp/gcp-oauth.keys.json",
        "GDRIVE_CREDENTIALS_FILE": "/Users/yourname/.config/mcp/gdrive-credentials.json"
      }
    }
  }
}

第 7 步：使用 Google Drive MCP

连接服务器后，你现在可以通过自然语言与 Google Drive 交互。

搜索文件

You: 在我的 Google Drive 中搜索 "API specification"

AI: [使用 gdrive 工具: search_files]
我找到了 3 个匹配的文件：
1. "API Specification v3.2" (Google Doc, 共享云端硬盘)
2. "API Specification - Draft" (Google Doc, 我的云端硬盘)
3. "api-spec-old.pdf" (PDF, 我的云端硬盘)

你想让我阅读其中哪一个？

读取文档

You: 阅读 "API Specification v3.2" 文档并为用户端点生成 TypeScript 接口。

AI: [使用 gdrive 工具: read_file]
我已经阅读了文档。以下是根据规格生成的 TypeScript 接口：

interface User {
  id: string;
  email: string;
  name: string;
  role: 'admin' | 'user' | 'viewer';
  createdAt: string;
  ...
}

读取电子表格数据

You: 读取 "Q4 Metrics" 电子表格并总结关键趋势。

AI: [使用 gdrive 工具: read_spreadsheet]
这是 Q4 指标摘要：
- 月活跃用户增长了 23% (4.5万 到 5.5万)
- 收入增长了 15% ($12万 到 $13.8万)
- 流失率从 4.2% 降至 3.8%
...

列出文件夹内容

You: "Engineering/Design Docs" 文件夹里有哪些文件？

AI: [使用 gdrive 工具: list_files]
Engineering/Design Docs 文件夹包含：
- Architecture Overview.gdoc (更新于 1月15日)
- Database Schema.gdoc (更新于 1月22日)
- API Design Principles.gdoc (更新于 12月3日)
- Deployment Runbook.gdoc (更新于 1月28日)

可用的 MCP 工具

Google Drive MCP 服务器公开了以下工具：

工具	描述	参数
`search_files`	按名称或内容搜索文件	`query` (string)
`read_file`	读取文件的内容	`fileId` (string)
`list_files`	列出文件夹中的文件	`folderId` (string, 可选)
`read_spreadsheet`	从 Google Sheets 读取数据	`spreadsheetId`, `range`

故障排除

"Token has been expired or revoked" (令牌已过期或已撤销)

重新进行身份验证：

npx -y @anthropic/mcp-server-gdrive auth --keys-file ~/.config/mcp/gcp-oauth.keys.json

"Access Not Configured" (访问未配置) 错误

确保在你的 GCP 项目中启用了 Google Drive API：

前往 console.cloud.google.com/apis/library
搜索 "Google Drive API"
确保显示为 Enabled（已启用）

服务器已启动但未出现工具

检查 MCP 服务器日志。在 Claude Desktop 中，查看：

# macOS
~/Library/Logs/Claude/mcp-gdrive.log

# 或者检查 Claude Desktop 开发者控制台
# View > Developer > Developer Tools

浏览器中出现 "App is not verified" (应用未验证) 警告

在 OAuth 流程中，由于你的应用处于测试模式，Google 可能会显示警告。点击 Advanced > Go to MCP Drive Server (unsafe) 以继续。对于个人使用的 OAuth 应用，这是正常现象。

文件未找到

MCP 服务器只能访问经过身份验证的 Google 账号有权查看的文件。如果找不到文件：

确保文件已与你的 Google 账号共享
检查文件是否位于你有权访问的共享云端硬盘中
尝试通过确切的文件名搜索

安全考量

令牌存储

OAuth 令牌存储在你的本地机器上。请保护它们：

# 设置严格的权限
chmod 600 ~/.config/mcp/gdrive-credentials.json
chmod 600 ~/.config/mcp/gcp-oauth.keys.json

权限范围限制

默认情况下，MCP 服务器请求对 Drive 的只读访问权限。除非服务器实现专门支持这些操作，否则它无法修改、删除或创建文件。

共享云端硬盘

如果你需要访问共享云端硬盘（团队驱动器），请确保你的 OAuth 同意屏幕包含 drive.readonly 范围，并且你的 Google Workspace 管理员未限制对共享云端硬盘的 API 访问。

超越文档访问

将 Google Drive 连接到你的 AI 助手是更大工作流中的一环。如果你正在构建需要生成视觉内容、视频或音频，同时又需要从 Drive 读取规格说明的 AI 驱动应用，Hypereal AI 提供了一个统一的媒体生成 API，可以与增强了 MCP 功能的开发环境完美配合。

总结

设置 Google Drive MCP 服务器涉及创建 GCP 项目、启用 Drive API、生成 OAuth 凭据以及配置 AI 客户端。连接之后，你的 AI 助手就可以搜索、读取和分析 Drive 中的任何文件。最大的设置障碍是 OAuth 配置，但一旦验证完成，令牌就会持久保存，连接将变得无缝。利用它来缩短文档与代码之间的距离。

如何在 2026 年设置 Google Drive MCP 服务器

你能用 Google Drive MCP 做什么

连接后，你的 AI 助手可以：

按名称或内容搜索你的 Google Drive 文件
读取 Google Docs、Sheets、Slides 以及上传的文件（PDF、文本文件、图像）
列出特定文件夹中的文件
从 Google Sheets 读取电子表格数据进行分析
访问共享云端硬盘和团队文件夹

实际应用场景

应用场景	示例
根据规格说明编写代码	"读取我们共享云端硬盘中的 API 规格说明并生成 TypeScript 类型"
数据分析	"从 Google Sheet 中提取第四季度指标并总结趋势"
文档编写	"检查 Drive 中的样式指南并重写此组件文档"
会议纪要	"阅读昨天的站会笔记并创建 Jira 工单"
设计审查	"阅读产品需求文档并与我的实现进行对比"

前提条件

在开始之前，你需要：

一个 Google Cloud Platform 账号（免费层级即可）
一个具有 Drive 访问权限的 Google Workspace 或个人 Gmail 账号
已安装 Node.js 18+
一个兼容 MCP 的 AI 客户端（Claude Desktop、Claude Code、Cursor 等）

第 1 步：创建 Google Cloud 项目

前往 Google Cloud Console
点击顶部的 Select a project（选择项目），然后点击 New Project（新建项目）
命名为类似 mcp-drive-server 的名称
点击 Create（创建）

第 2 步：启用 Google Drive API

在新项目中，前往 APIs & Services > Library
搜索 "Google Drive API"
点击进入并点击 Enable（启用）
如果你需要访问电子表格，还请搜索并启用 "Google Sheets API"

第 3 步：创建 OAuth 2.0 凭据

MCP 服务器需要 OAuth 凭据才能代表你访问 Drive。

前往 APIs & Services > Credentials
点击 Create Credentials > OAuth client ID
如果系统提示，请先配置 OAuth 同意屏幕（Consent Screen）：
- 选择 External（外部，如果你有 Workspace 则选 Internal）
- 填写应用名称：MCP Drive Server
- 添加你的电子邮件作为测试用户
- 同意屏幕上无需添加范围（Scopes）（它们会在运行时请求）
回到凭据页面，选择 Desktop app（桌面应用）作为应用类型
命名为 MCP Drive Server
点击 Create（创建）
下载 JSON 文件并将其保存为 gcp-oauth.keys.json

# 将下载的文件移动到安全位置
mkdir -p ~/.config/mcp
mv ~/Downloads/client_secret_*.json ~/.config/mcp/gcp-oauth.keys.json

第 4 步：安装 Google Drive MCP 服务器

安装官方 Google Drive MCP 服务器：

npm install -g @anthropic/mcp-server-gdrive

或者通过 npx 使用（无需安装）：

npx -y @anthropic/mcp-server-gdrive

第 5 步：进行 Google 身份验证

第一次运行服务器时，它需要完成 OAuth 流程以获取对 Google Drive 的访问权限。

# 运行身份验证流程
npx -y @anthropic/mcp-server-gdrive auth --keys-file ~/.config/mcp/gcp-oauth.keys.json

这将：

在浏览器中打开 Google 登录页面
请求你授予 MCP 服务器访问 Drive 的权限
在本地保存刷新令牌以供将来使用

令牌存储在 ~/.config/mcp/gdrive-credentials.json。请妥善保管此文件。

# 验证令牌是否已保存
ls -la ~/.config/mcp/gdrive-credentials.json

第 6 步：连接到你的 AI 客户端

Claude Desktop

编辑你的 Claude Desktop 配置文件：

# macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Windows
code %APPDATA%\Claude\claude_desktop_config.json

添加 Google Drive 服务器配置：

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-gdrive"],
      "env": {
        "GDRIVE_OAUTH_KEYS_FILE": "/Users/yourname/.config/mcp/gcp-oauth.keys.json",
        "GDRIVE_CREDENTIALS_FILE": "/Users/yourname/.config/mcp/gdrive-credentials.json"
      }
    }
  }
}

重启 Claude Desktop。你应该能在工具菜单（锤子图标）中看到可用的 Google Drive 工具。

Claude Code (CLI)

将 MCP 服务器添加到你的 Claude Code 配置中：

claude mcp add gdrive \
  --command "npx" \
  --args "-y" "@anthropic/mcp-server-gdrive" \
  --env "GDRIVE_OAUTH_KEYS_FILE=/Users/yourname/.config/mcp/gcp-oauth.keys.json" \
  --env "GDRIVE_CREDENTIALS_FILE=/Users/yourname/.config/mcp/gdrive-credentials.json"

或者直接编辑配置文件 ~/.claude/mcp.json：

{
  "servers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-gdrive"],
      "env": {
        "GDRIVE_OAUTH_KEYS_FILE": "/Users/yourname/.config/mcp/gcp-oauth.keys.json",
        "GDRIVE_CREDENTIALS_FILE": "/Users/yourname/.config/mcp/gdrive-credentials.json"
      }
    }
  }
}

Cursor

在 Cursor 的设置中添加 MCP 服务器：

打开 Settings (Cmd+,)
搜索 "MCP"
点击 Edit in settings.json 或导航至 MCP 配置
添加 Google Drive 服务器：

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-gdrive"],
      "env": {
        "GDRIVE_OAUTH_KEYS_FILE": "/Users/yourname/.config/mcp/gcp-oauth.keys.json",
        "GDRIVE_CREDENTIALS_FILE": "/Users/yourname/.config/mcp/gdrive-credentials.json"
      }
    }
  }
}

第 7 步：使用 Google Drive MCP

连接服务器后，你现在可以通过自然语言与 Google Drive 交互。

搜索文件

You: 在我的 Google Drive 中搜索 "API specification"

AI: [使用 gdrive 工具: search_files]
我找到了 3 个匹配的文件：
1. "API Specification v3.2" (Google Doc, 共享云端硬盘)
2. "API Specification - Draft" (Google Doc, 我的云端硬盘)
3. "api-spec-old.pdf" (PDF, 我的云端硬盘)

你想让我阅读其中哪一个？

读取文档

You: 阅读 "API Specification v3.2" 文档并为用户端点生成 TypeScript 接口。

AI: [使用 gdrive 工具: read_file]
我已经阅读了文档。以下是根据规格生成的 TypeScript 接口：

interface User {
  id: string;
  email: string;
  name: string;
  role: 'admin' | 'user' | 'viewer';
  createdAt: string;
  ...
}

读取电子表格数据

You: 读取 "Q4 Metrics" 电子表格并总结关键趋势。

AI: [使用 gdrive 工具: read_spreadsheet]
这是 Q4 指标摘要：
- 月活跃用户增长了 23% (4.5万 到 5.5万)
- 收入增长了 15% ($12万 到 $13.8万)
- 流失率从 4.2% 降至 3.8%
...

列出文件夹内容

You: "Engineering/Design Docs" 文件夹里有哪些文件？

AI: [使用 gdrive 工具: list_files]
Engineering/Design Docs 文件夹包含：
- Architecture Overview.gdoc (更新于 1月15日)
- Database Schema.gdoc (更新于 1月22日)
- API Design Principles.gdoc (更新于 12月3日)
- Deployment Runbook.gdoc (更新于 1月28日)

可用的 MCP 工具

Google Drive MCP 服务器公开了以下工具：

工具	描述	参数
`search_files`	按名称或内容搜索文件	`query` (string)
`read_file`	读取文件的内容	`fileId` (string)
`list_files`	列出文件夹中的文件	`folderId` (string, 可选)
`read_spreadsheet`	从 Google Sheets 读取数据	`spreadsheetId`, `range`

故障排除

"Token has been expired or revoked" (令牌已过期或已撤销)

重新进行身份验证：

npx -y @anthropic/mcp-server-gdrive auth --keys-file ~/.config/mcp/gcp-oauth.keys.json

"Access Not Configured" (访问未配置) 错误

确保在你的 GCP 项目中启用了 Google Drive API：

前往 console.cloud.google.com/apis/library
搜索 "Google Drive API"
确保显示为 Enabled（已启用）

服务器已启动但未出现工具

检查 MCP 服务器日志。在 Claude Desktop 中，查看：

# macOS
~/Library/Logs/Claude/mcp-gdrive.log

# 或者检查 Claude Desktop 开发者控制台
# View > Developer > Developer Tools

浏览器中出现 "App is not verified" (应用未验证) 警告

文件未找到

MCP 服务器只能访问经过身份验证的 Google 账号有权查看的文件。如果找不到文件：

确保文件已与你的 Google 账号共享
检查文件是否位于你有权访问的共享云端硬盘中
尝试通过确切的文件名搜索

安全考量

令牌存储

OAuth 令牌存储在你的本地机器上。请保护它们：

# 设置严格的权限
chmod 600 ~/.config/mcp/gdrive-credentials.json
chmod 600 ~/.config/mcp/gcp-oauth.keys.json

权限范围限制

默认情况下，MCP 服务器请求对 Drive 的只读访问权限。除非服务器实现专门支持这些操作，否则它无法修改、删除或创建文件。

开始使用 Hypereal 构建

如何在 2026 年设置 Google Drive MCP 服务器

你能用 Google Drive MCP 做什么

实际应用场景

前提条件

第 1 步：创建 Google Cloud 项目

第 2 步：启用 Google Drive API

第 3 步：创建 OAuth 2.0 凭据

第 4 步：安装 Google Drive MCP 服务器

第 5 步：进行 Google 身份验证

第 6 步：连接到你的 AI 客户端

Claude Desktop

Claude Code (CLI)

Cursor

第 7 步：使用 Google Drive MCP

搜索文件

读取文档

读取电子表格数据

列出文件夹内容

可用的 MCP 工具

故障排除

"Token has been expired or revoked" (令牌已过期或已撤销)

"Access Not Configured" (访问未配置) 错误

服务器已启动但未出现工具

浏览器中出现 "App is not verified" (应用未验证) 警告

文件未找到

安全考量

令牌存储

权限范围限制

共享云端硬盘

超越文档访问

总结

相关文章

如何从零开始构建 MCP Server (2026)

如何设置 Context7 MCP Server (2026)

FastMCP：在几分钟内构建 MCP 服务器 (2026)

立即开始构建

开始使用 Hypereal 构建

如何在 2026 年设置 Google Drive MCP 服务器

你能用 Google Drive MCP 做什么

实际应用场景

前提条件

第 1 步：创建 Google Cloud 项目

第 2 步：启用 Google Drive API

第 3 步：创建 OAuth 2.0 凭据

第 4 步：安装 Google Drive MCP 服务器

第 5 步：进行 Google 身份验证

第 6 步：连接到你的 AI 客户端

Claude Desktop

Claude Code (CLI)

Cursor

第 7 步：使用 Google Drive MCP

搜索文件

读取文档

读取电子表格数据

列出文件夹内容

可用的 MCP 工具

故障排除

"Token has been expired or revoked" (令牌已过期或已撤销)

"Access Not Configured" (访问未配置) 错误

服务器已启动但未出现工具

浏览器中出现 "App is not verified" (应用未验证) 警告

文件未找到

安全考量

令牌存储

权限范围限制

共享云端硬盘

超越文档访问

总结

相关文章

如何从零开始构建 MCP Server (2026)

如何设置 Context7 MCP Server (2026)

FastMCP：在几分钟内构建 MCP 服务器 (2026)

立即开始构建