MCP Google Workspace 服务器

代码验证 PyPI 版本许可证：MIT 代码样式：黑色

模型上下文协议 (MCP) 服务器使 AI 代理能够与 Google Workspace（Drive、Docs 和 Sheets）服务进行交互。

🌟 功能

Google Drive：搜索文件、创建文件夹
Google Docs：创建、阅读、更新文档
Google 表格：创建电子表格、读取/写入单元格值
多种传输模式：stdio（默认）、SSE、WebSocket
MCP 兼容客户端支持（Cursor 等）

📋 安装

使用 uv（推荐）

uvx mcp-google-suite

使用 pip

pip install mcp-google-suite

开发设置

# Clone and install
git clone git@github.com:adexltd/mcp-google-suite.git && cd mcp-google-suite
uv venv && source .venv/bin/activate  # or .venv\Scripts\activate on Windows
uv pip install -e .

🔧 配置

为 MCP 客户端配置

添加到您的客户端设置（例如 Cursor、Claude）：

使用 uvx（推荐）：

{
  "mcpServers": {
    "mcp-google-suite": {
      "command": "uvx",
      "args": ["mcp-google-suite"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "~/.google/server-creds.json",
        "GOOGLE_OAUTH_CREDENTIALS": "~/.google/oauth.keys.json"
      }
    }
  }
}

使用pip安装：

{
  "mcpServers": {
    "mcp-google-suite": {
      "command": "python",
      "args": ["-m", "mcp_google_suite"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "~/.google/server-creds.json",
        "GOOGLE_OAUTH_CREDENTIALS": "~/.google/oauth.keys.json"
      }
    }
  }
}

Google OAuth 设置

访问Google Cloud Console
启用 Drive、Docs 和 Sheets API
创建 OAuth 2.0 凭据
保存为~/.google/oauth.keys.json
运行mcp-google auth进行身份验证

可用工具

驱动操作

drive_search_files ：在 Google Drive 中搜索文件
- query （字符串，必需）：搜索查询
- page_size （整数，可选）：要返回的结果数
drive_create_folder ：创建新文件夹
- name （字符串，必需）：文件夹名称
- parent_id （字符串，可选）：父文件夹 ID

文档操作

docs_create ：创建新文档
- title （字符串，必需）：文档标题
- content （字符串，可选）：初始内容
docs_get_content ：获取文档内容
- document_id （字符串，必需）：文档 ID
docs_update_content ：更新文档内容
- document_id （字符串，必需）：文档 ID
- content （字符串，必需）：新内容

工作表操作

sheets_create ：创建一个新的电子表格
- title （字符串，必需）：电子表格标题
- sheets （数组，可选）：工作表名称
sheets_get_values ：获取单元格值
- spreadsheet_id （字符串，必需）：电子表格 ID
- range （字符串，必需）：A1 符号范围
sheets_update_values ：更新单元格值
- spreadsheet_id （字符串，必需）：电子表格 ID
- range （字符串，必需）：A1 符号范围
- values （数组，必需）：值的二维数组

🛠️ 开发

# Install dev dependencies
uv pip install -e ".[dev]"

# Setup pre-commit hooks
pre-commit install

# Run tests
pytest

# Format code
black . && ruff check --fix .

🔍 调试

使用 MCP Inspector 进行交互式测试：

# Using uvx
npx @modelcontextprotocol/inspector uvx mcp-google

# For development
cd path/to/mcp-google-suite
npx @modelcontextprotocol/inspector uv run mcp-google

📚 资源

🤝 贡献

请阅读CONTRIBUTING.md了解我们的行为准则和提交拉取请求的流程的详细信息。

🔒 安全

请参阅SECURITY.md以了解报告漏洞和最佳实践。

📄 许可证

MIT 许可证 - 有关详细信息，请参阅LICENSE文件。

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

模型上下文协议服务器可与 Google Workspace 无缝集成，允许通过安全的 OAuth2 身份验证对 Google Drive、Docs 和 Sheets 进行操作。

Related MCP Servers

Google Cloud MCP Server
krzko
A
security
A
license
A
quality
A Model Context Protocol server that connects to Google Cloud services, allowing users to query logs, interact with Spanner databases, and analyze Cloud Monitoring metrics through natural language interaction.
Last updated -
40
68
56
Apache 2.0
mcp-google-sheets
xing5
-
security
A
license
-
quality
A Model Context Protocol server that integrates with Google Drive and Google Sheets, enabling users to create, read, update, and manage spreadsheets through natural language commands.
Last updated -
400
MIT License
MCP Google Workspace Server
josedu90
A
security
A
license
A
quality
A Model Context Protocol server that enables AI agents to interact with Google Workspace services including Drive, Docs, and Sheets through natural language commands.
Last updated -
8
MIT License
Google Docs MCP Server
penysho
A
security
F
license
A
quality
A Model Context Protocol server that provides an interface for AI models to interact with Google Docs, enabling reading, creating, updating, and searching Google Documents.
Last updated -
4
8

View all related MCP servers

MCP Google Suite