Google Workspace
About
Integrates with Google Workspace to enable document creation, search, and management across Drive, Docs, and Sheets using OAuth authentication and multiple transport modes
Details
- Author
- adexltd
- Repository
- adexltd/mcp-google-suite
- GitHub stars
- 1
- License
- MIT License
- Categories
- Productivity, Knowledge Base, Other, Developer Tools, Design, Workplace, File Management, AI, Search, Frontend, Infrastructure, Security
Jump to
- 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.)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Google WorkspaceCommand (node, npx, python, etc.)uvxArguments-
Argument 1
mcp-google-suite
Environment-
GOOGLE_OAUTH_CREDENTIALS
~/.google/oauth.keys.json -
GOOGLE_APPLICATION_CREDENTIALS
~/.google/server-creds.json
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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 .
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"
}
}
}
}
1. Visit Google Cloud Console
2. Enable Drive, Docs, and Sheets APIs
3. Create OAuth 2.0 credentials
4. Save as ~/.google/oauth.keys.json
5. Run mcp-google auth to authenticate
uv pip install -e ".[dev]"
pre-commit install
drive_search_files
Search files in Google Drive. Parameters: query (string, required), page_size (integer, optional)
drive_create_folder
Create a new folder in Google Drive. Parameters: name (string, required), parent_id (string, optional)
docs_create
Create a new document in Google Docs. Parameters: title (string, required), content (string, optional)
docs_get_content
Get content of a document in Google Docs. Parameters: document_id (string, required)
docs_update_content
Update content of a document in Google Docs. Parameters: document_id (string, required), content (string, required)
sheets_create
Create a new spreadsheet in Google Sheets. Parameters: title (string, required), sheets (array, optional)
sheets_get_values
Get values from cells in a spreadsheet in Google Sheets. Parameters: spreadsheet_id (string, required), range (string, required)
sheets_update_values
Update values in cells of a spreadsheet in Google Sheets. Parameters: spreadsheet_id (string, required), range (string, required), values (array, required)
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 valuesClaude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"google workspace": {
"env": {
"GOOGLE_OAUTH_CREDENTIALS": "~/.google/oauth.keys.json",
"GOOGLE_APPLICATION_CREDENTIALS": "~/.google/server-creds.json"
},
"args": [
"mcp-google-suite"
],
"command": "uvx"
}
}
}Linux
{
"env": {
"GOOGLE_OAUTH_CREDENTIALS": "~/.google/oauth.keys.json",
"GOOGLE_APPLICATION_CREDENTIALS": "~/.google/server-creds.json"
},
"args": [
"mcp-google-suite"
],
"command": "uvx"
}Macos
{
"env": {
"GOOGLE_OAUTH_CREDENTIALS": "~/.google/oauth.keys.json",
"GOOGLE_APPLICATION_CREDENTIALS": "~/.google/server-creds.json"
},
"args": [
"mcp-google-suite"
],
"command": "uvx"
}Windows
{
"env": {
"GOOGLE_OAUTH_CREDENTIALS": "~/.google/oauth.keys.json",
"GOOGLE_APPLICATION_CREDENTIALS": "~/.google/server-creds.json"
},
"args": [
"-m",
"mcp_google_suite"
],
"command": "python"
}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
```bashSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
