MCP 谷歌套件

MCP Google Workspace 服务器

模型上下文协议 (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文件。

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

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.

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

Related MCP Servers

Nash MCP Server
nash-app
-
security
A
license
-
quality
A Model Context Protocol server that enables seamless execution of commands, Python code, web content fetching, and reusable task management with secure credentials handling.
Last updated -
2
Python
MIT License
Google Cloud MCP Server
krzko
-
security
F
license
-
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 -
16
2
TypeScript
MCP Google Map Server
cablate
A
security
A
license
A
quality
A Model Context Protocol server that provides Google Maps API integration, allowing users to search locations, get place details, geocode addresses, calculate distances, obtain directions, and retrieve elevation data through LLM processing capabilities.
Last updated -
7
163
25
TypeScript
MIT License
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 -
134
Python
MIT License

View all related MCP servers

MCP Google Suite