Which integrations are available for this server?

Enables creation, reading, and updating of [Google Docs](/mcp/servers/integrations/google-docs) with tools to manage document content Provides file search capabilities and folder creation within [Google Drive](/mcp/servers/integrations/google-drive) Allows creation of spreadsheets and managing cell values through range-based operations

MCP Google Workspace Server

codecov PyPI version License: MIT Code style: black

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

Related MCP server: mcp-google-sheets

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

One-click Deploy

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Reddit Discussion

Related Servers

MCP Google Suite