Skip to main content
Glama
MCP Google Workspace Server

MCP Google Workspace Server

by josedu90

MCP Google Workspace 服务器

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

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

🌟 功能

  • Google Drive:搜索文件、创建文件夹

  • Google Docs:创建、阅读、更新文档

  • Google 表格:创建电子表格、读取/写入单元格值

  • 多种传输模式:stdio(默认)、SSE、WebSocket

  • MCP 兼容客户端支持(Cursor 等)

Related MCP server: MCP Google Suite

📋 安装

使用 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 设置

  1. 访问Google Cloud Console

  2. 启用 Drive、Docs 和 Sheets API

  3. 创建 OAuth 2.0 凭据

  4. 保存为~/.google/oauth.keys.json

  5. 运行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文件。

Available Tools

8 tools
docs_createC

Create a new Google Doc

Inputs: title (required), content.

docs_get_contentC

Get the contents of a Google Doc

Inputs: document_id (required).

docs_update_contentC

Update the content of a Google Doc

Inputs: content (required), document_id (required).

drive_create_folderC

Create a new folder in Google Drive

Inputs: name (required), parent_id.

drive_search_filesC

Search for files in Google Drive

Inputs: query (required), page_size.

sheets_createC

Create a new Google Sheet

Inputs: title (required), sheets.

sheets_get_valuesC

Get values from a Google Sheet range

Inputs: range (required), spreadsheet_id (required).

sheets_update_valuesC

Update values in a Google Sheet range

Inputs: range (required), spreadsheet_id (required), values (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 8 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose with no ambiguity, as each is scoped to a specific Google Workspace service (Docs, Drive, Sheets) and action (create, get/read, update, search). The naming prefixes (docs_, drive_, sheets_) immediately differentiate the domains, preventing misselection.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with service prefixes, using snake_case uniformly (e.g., docs_create, sheets_update_values). This predictable naming scheme makes it easy for an agent to understand and navigate the toolset without confusion.

    Tool Count5/5

    With 8 tools, the count is well-scoped for covering core operations across three Google Workspace services. Each tool earns its place by providing essential CRUD-like functionality (create, get, update) and search capabilities, avoiding bloat while ensuring practical coverage.

    Completeness4/5

    The toolset offers strong coverage for Docs, Drive, and Sheets with create, read, update, and search operations, but minor gaps exist, such as missing delete operations for Docs and Sheets, and no update for Drive folders. Agents can work around these gaps, but the surface isn't fully complete for full lifecycle management.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      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.
      16,929 PyPI
      1,021
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol server that provides seamless integration with Google Workspace, allowing operations with Google Drive, Docs, and Sheets through secure OAuth2 authentication.
      8
      38 PyPI
      3
      MIT