
MCP Google Workspace Server

2025.03.28
1
PythonGoogle Workspace 集成文档管理电子表格管理交流协作开发效率
MCP Google Workspace Server 是一个基于 Model Context Protocol (MCP) 的服务,旨在使 AI 代理能够与 Google Workspace(包括 Drive、Docs 和 Sheets)服务进行交互。该服务提供了丰富的功能,包括文件搜索、文件夹创建、文档和电子表格的创建、读取和更新等。支持多种传输模式,如 stdio、SSE 和 WebSocket,并且兼容 MCP 客户端(如 Cursor)。
View on GitHub
Overview
🌟 核心功能
- Google Drive: 搜索文件、创建文件夹
- Google Docs: 创建、读取、更新文档
- Google Sheets: 创建电子表格、读取/写入单元格值
- 多种传输模式: stdio(默认)、SSE、WebSocket
- MCP 兼容客户端支持: 如 Cursor 等
📋 适用场景
- AI 代理与 Google Workspace 服务的交互
- 自动化文档和电子表格管理
- 团队协作中的文件共享和管理
🛠️ 工具列表
Drive 操作
drive_search_files
: 在 Google Drive 中搜索文件drive_create_folder
: 创建新文件夹
Docs 操作
docs_create
: 创建新文档docs_get_content
: 获取文档内容docs_update_content
: 更新文档内容
Sheets 操作
sheets_create
: 创建新电子表格sheets_get_values
: 获取单元格值sheets_update_values
: 更新单元格值
🔧 常见问题解答
- 如何配置 Google OAuth?
-
访问 Google Cloud Console,启用 Drive、Docs 和 Sheets API,创建 OAuth 2.0 凭据并保存为
~/.google/oauth.keys.json
,然后运行mcp-google auth
进行认证。 -
如何调试?
- 使用 MCP Inspector 进行交互式测试。
📋 使用教程
使用依赖
确保已安装 Python 和 pip。
安装教程
使用 uv(推荐)
uvx mcp-google-suite
使用 pip
pip install mcp-google-suite
开发设置
git clone [email protected]:adexltd/mcp-google-suite.git && cd mcp-google-suite
uv venv && source .venv/bin/activate # 或在 Windows 上使用 .venv\Scripts\activate
uv pip install -e .
调试方式
使用 MCP Inspector 进行调试:
npx @modelcontextprotocol/inspector uvx mcp-google
对于开发环境:
cd path/to/mcp-google-suite
npx @modelcontextprotocol/inspector uv run mcp-google