MCP Google Workspace 服务器

MCP Google Workspace Server

A Model Context Protocol (MCP) server enabling AI agents to interact with Google Workspace (Drive, Docs, and Sheets) services.

🌟 Features

Google Drive: Search files, create folders
Google Docs: Create, read, update documents
Google Sheets: Create spreadsheets, read/write cell values
Multiple transport modes: stdio (default), SSE, WebSocket
MCP-compatible client support (Cursor, etc.)

📋 Installation

Using uv (recommended)

uvx mcp-google-suite

Using pip

pip install mcp-google-suite

Development setup

# 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 .

🔧 Configuration

Configure for MCP Clients

Add to your client settings (e.g. Cursor, Claude):

Using uvx (recommended):

{
  "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"
      }
    }
  }
}

Using pip installation:

{
  "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 Setup

Visit Google Cloud Console
Enable Drive, Docs, and Sheets APIs
Create OAuth 2.0 credentials
Save as ~/.google/oauth.keys.json
Run mcp-google auth to authenticate

Available Tools

Drive Operations

drive_search_files: Search files in Google Drive
- query (string, required): Search query
- page_size (integer, optional): Number of results to return
drive_create_folder: Create a new folder
- name (string, required): Folder name
- parent_id (string, optional): Parent folder ID

Docs Operations

docs_create: Create a new document
- title (string, required): Document title
- content (string, optional): Initial content
docs_get_content: Get document content
- document_id (string, required): Document ID
docs_update_content: Update document content
- document_id (string, required): Document ID
- content (string, required): New content

Sheets Operations

sheets_create: Create a new spreadsheet
- title (string, required): Spreadsheet title
- sheets (array, optional): Sheet names
sheets_get_values: Get cell values
- spreadsheet_id (string, required): Spreadsheet ID
- range (string, required): A1 notation range
sheets_update_values: Update cell values
- spreadsheet_id (string, required): Spreadsheet ID
- range (string, required): A1 notation range
- values (array, required): 2D array of values

🛠️ Development

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

# Setup pre-commit hooks
pre-commit install

# Run tests
pytest

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

🔍 Debugging

Use the MCP Inspector for interactive testing:

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

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

📚 Resources

🤝 Contributing

Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

🔒 Security

See SECURITY.md for reporting vulnerabilities and best practices.

📄 License

MIT License - See LICENSE file for details.

Install 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

模型上下文协议服务器，使 AI 代理能够通过自然语言命令与 Google Workspace 服务（包括 Drive、Docs 和 Sheets）进行交互。

Related Resources

Reddit Discussion about this server

Related MCP Servers

Gmail MCP Server
zacco16
-
security
F
license
-
quality
A Model Context Protocol server that enables AI assistants to interact with Gmail services, supporting email operations, draft management, and calendar functionality through Google API integration.
Last updated -
1,010
1
TypeScript
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 -
343
Python
MIT License
MCP Google Suite
adexltd
A
security
A
license
A
quality
A Model Context Protocol server that provides seamless integration with Google Workspace, allowing operations with Google Drive, Docs, and Sheets through secure OAuth2 authentication.
Last updated -
8
3
Python
MIT License
Claude MCP x Google Docs
a-bonus
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to read from, append to, and format text in Google Documents programmatically.
Last updated -
80
TypeScript
MIT License

View all related MCP servers

MCP Google Workspace Server

MCP Google Workspace Server

🌟 Features

📋 Installation

Using uv (recommended)

Using pip

Development setup

🔧 Configuration

Configure for MCP Clients

Google OAuth Setup

Available Tools

Drive Operations

Docs Operations

Sheets Operations

🛠️ Development

🔍 Debugging

📚 Resources

🤝 Contributing

🔒 Security

📄 License

Tools

Related Resources

Related MCP Servers

Gmail MCP Server

mcp-google-sheets

MCP Google Suite

Claude MCP x Google Docs

Appeared in Searches

MCP directory API