Google Drive & Sheets MCP Server

基本能力

产品定位

mcp-google-workspace 是一个用于与 Google Drive 和 Google Sheets 交互的 MCP 服务器，旨在提供高效的 Google Workspace 服务集成能力。

核心功能

1. Google Drive 操作
2. 列出 Google Drive 中的文件，支持多种过滤选项（MIME 类型、自定义搜索查询、可配置的页面大小、自定义排序）。
3. Google Sheets 操作
4. 读取 Google Sheets 数据（支持指定范围和主要维度）。
5. 写入数据到 Google Sheets。
6. 创建新的电子表格（支持自定义标题和多工作表）。
7. 清除电子表格中的范围数据。

适用场景

• 自动化 Google Drive 文件管理。
• 批量处理 Google Sheets 数据。
• 集成到代理工作流中，实现高效的 Google Workspace 服务调用。

工具列表

1. Drive Tools
2. list_files: 列出并过滤 Drive 文件，支持自定义参数。
3. 通过 resources/list 端点暴露可用功能。
4. Sheets Tools
5. read_values: 读取电子表格数据，支持维度控制。
6. write_values: 写入数据到电子表格。
7. create_spreadsheet: 创建新的电子表格。
8. clear_values: 清除电子表格中的范围数据。
9. 通过 resources/list 端点暴露可用功能。

常见问题解答

• 需要确保已启用 Google Drive 和 Google Sheets API。
• 需要配置 OAuth 2.0 凭据。
• 需要设置环境变量（ACCESS_TOKEN, GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN）。

使用教程

使用依赖

1. 安装最新稳定版本的 Rust。
2. 创建一个 Google Cloud 项目并启用 Drive 和 Sheets API。
3. 为 Google Cloud 项目配置 OAuth 2.0 凭据。

安装教程

通过 Cargo 从 GitHub 安装 mcp-google 二进制文件：

cargo install --git https://github.com/distrihub/mcp-google-workspace.git

配置

1. 设置 Google Cloud 项目。
2. 启用 Google Drive 和 Google Sheets API。
3. 创建 OAuth 2.0 凭据。
4. 设置环境变量：
5. ACCESS_TOKEN: Google OAuth 访问令牌。
6. GOOGLE_CLIENT_ID: OAuth 客户端 ID。
7. GOOGLE_CLIENT_SECRET: OAuth 客户端密钥。
8. GOOGLE_REFRESH_TOKEN: OAuth 刷新令牌。

调试方式

1. 启动 Drive MCP 服务器：

mcp-google drive --access-token <your-access-token>

1. 启动 Sheets MCP 服务器：

mcp-google sheets --access-token <your-access-token>

1. 刷新 OAuth 令牌：

mcp-google refresh \
  --client-id <your-client-id> \
  --client-secret <your-client-secret> \
  --refresh-token <your-refresh-token>

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。