hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Enables creation, reading, and updating of Google Docs with tools to manage document content
Provides file search capabilities and folder creation within Google Drive
Allows creation of spreadsheets and managing cell values through range-based operations

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

A

license - permissive license

-

quality - not tested

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

MCP Google Suite