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 .venvScriptsactivate 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 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
- Documentation
- MCP Inspector
- Pre-commit Hooks
- Google Cloud Console
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.
Google Workspace Server
Project Details
- josedu90/mcp-suiteg
- MIT License
- Last Updated: 4/29/2025
Recomended MCP Servers
MCP Server for local screen shot.
Summarise Your YT videos with your fav LLMs
A simple TypeScript library for creating MCP servers.
A powerful multi-database server implementing the Model Context Protocol (MCP) to provide AI assistants with structured access to...
This a simple implementation of an MCP server using iFlytek. It enables calling iFlytek workflows through MCP tools.
This MCP server exposes the WeatherXM PRO APIs as MCP tools, allowing clients to access weather station data,...
This read-only MCP Server allows you to connect to Azure Table data from Claude Desktop through CData JDBC...
This is an MCP server that interacts with a PocketBase instance. It allows you to fetch, list, create,...
This project is an arXiv paper retrieval and search service implemented through a custom MCP (Multi-Capability Provider) framework. It...
A task management MCP server that provides comprehensive project and task tracking capabilities