MCP Google Workspace Server
The MCP Google Workspace Server enables AI agents to interact with Google Drive, Docs, and Sheets services via the Model Context Protocol.
Capabilities include:
Google Drive: Search files using queries and pagination, create folders with optional parent folders
Google Docs: Create documents with titles and optional content, retrieve and update document content by ID
Google Sheets: Create spreadsheets, retrieve and update cell values using A1 notation range
The server supports multiple transport modes (stdio, SSE, WebSocket), is compatible with MCP clients like Cursor, and requires Google OAuth setup for authentication.
Integrates with Codecov for code coverage reporting
Connects with GitHub for CI workflows and repository management
Provides capabilities to create, read, and update Google Docs documents
Enables searching for files and creating folders in Google Drive
Allows creating spreadsheets and reading/writing cell values in Google Sheets
Publishes the package to PyPI for distribution
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Google Workspace Server search for budget spreadsheets in my Drive"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.)
Related MCP server: MCP Google Suite
π Installation
Using uv (recommended)
uvx mcp-google-suiteUsing pip
pip install mcp-google-suiteDevelopment 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.jsonRun
mcp-google authto authenticate
Available Tools
Drive Operations
drive_search_files: Search files in Google Drivequery(string, required): Search querypage_size(integer, optional): Number of results to return
drive_create_folder: Create a new foldername(string, required): Folder nameparent_id(string, optional): Parent folder ID
Docs Operations
docs_create: Create a new documenttitle(string, required): Document titlecontent(string, optional): Initial content
docs_get_content: Get document contentdocument_id(string, required): Document ID
docs_update_content: Update document contentdocument_id(string, required): Document IDcontent(string, required): New content
Sheets Operations
sheets_create: Create a new spreadsheettitle(string, required): Spreadsheet titlesheets(array, optional): Sheet names
sheets_get_values: Get cell valuesspreadsheet_id(string, required): Spreadsheet IDrange(string, required): A1 notation range
sheets_update_values: Update cell valuesspreadsheet_id(string, required): Spreadsheet IDrange(string, required): A1 notation rangevalues(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.
Available Tools
8 toolsdocs_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
Scored across 8 tools
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.
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.
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.
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
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yoβ¦
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
The Google GKE MCP server is a managed Model Context Protocol server that provides AI applications with tools to manage Google Kubernetes Engine (GKE) clusters and Kubernetes resources. It exposes a structured, discoverable interface that allows AI agents to interact with GKE and Kubernetes APIs, enabling them to inspect cluster configurations, retrieve Kubernetes resource YAMLs, monitor operations like cluster upgrades, diagnose issues, and optimize costsβall without needing to parse text output or use complex kubectl commands.
Hosted Google Calendar MCP server for AI agents. No self-hosting or Google Cloud setup.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA 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 PyPI1,021MIT
- AlicenseAqualityDmaintenanceA Model Context Protocol server that provides seamless integration with Google Workspace, allowing operations with Google Drive, Docs, and Sheets through secure OAuth2 authentication.838 PyPI3MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol (MCP) server that connects AI agents to Google Workspace (Gmail, Calendar, Drive, Docs, Sheets, and Slides).302MIT
- AlicenseNot gradedqualityBmaintenanceA full-featured Model Context Protocol server that gives AI assistants real-time access to Google Workspace services including Drive, Gmail, Calendar, Sheets, Docs, and Apps Script.2,201 PyPI12MIT