Comprehensive, highly performant Google Workspace MCP Server with complete coverage for Calendar, Gmail, Docs, Sheets, Slides, Chat, Forms & Drive!
This is the single most feature-complete Google Workspace MCP server
Full natural language control over Google Calendar, Drive, Gmail, Docs, Sheets, Slides, Forms, and Chat through all MCP clients, AI assistants and developer tools
See it in action:
A production-ready MCP server that integrates all major Google Workspace services with AI assistants. Built with FastMCP for optimal performance, featuring advanced authentication handling, service caching, and streamlined development patterns.
mcpo
Run instantly without manual installation - you must set the
GOOGLE_CLIENT_SECRETS
environment variable with the path to yourclient_secret.json
when using uvx as you won't have a repo directory to pull from.
# Start the server with all Google Workspace tools
uvx workspace-mcp
# Start with specific tools only
uvx workspace-mcp --tools gmail drive calendar
# Start in HTTP mode for debugging
uvx workspace-mcp --transport streamable-http
Requires Python 3.11+ and uvx. The package is available on PyPI.
For development or customization:
git clone https://github.com/taylorwilsdon/google_workspace_mcp.git
cd google_workspace_mcp
uv run main.py
Google Cloud Setup:
client_secret.json
in project root
client_secret.json
, you can set the GOOGLE_CLIENT_SECRETS
environment variable with that pathhttp://localhost:8000/oauth2callback
Environment:
export OAUTHLIB_INSECURE_TRANSPORT=1 # Development only
Server Configuration: The server's base URL and port can be customized using environment variables:
WORKSPACE_MCP_BASE_URI
: Sets the base URI for the server (default: http://localhost). This affects the server_url used for Gemini native function calling and the OAUTH_REDIRECT_URI.WORKSPACE_MCP_PORT
: Sets the port the server listens on (default: 8000). This affects the server_url, port, and OAUTH_REDIRECT_URI.# Default (stdio mode for MCP clients)
uv run main.py
# HTTP mode (for web interfaces and debugging)
uv run main.py --transport streamable-http
# Single-user mode (simplified authentication)
uv run main.py --single-user
# Selective tool registration (only register specific tools)
uv run main.py --tools gmail drive calendar
uv run main.py --tools sheets docs
uv run main.py --single-user --tools gmail # Can combine with other flags
# Docker
docker build -t workspace-mcp .
docker run -p 8000:8000 -v $(pwd):/app workspace-mcp --transport streamable-http
Available Tools for --tools
flag: gmail
, drive
, calendar
, docs
, sheets
, forms
, chat
The server supports two transport modes:
Option 1: Auto-install (Recommended)
python install_claude.py
Option 2: Manual Configuration
~/Library/Application Support/Claude/claude_desktop_config.json
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"google_workspace": {
"command": "uvx",
"args": ["workspace-mcp"]
}
}
}
Alternative (Development Installation):
{
"mcpServers": {
"google_workspace": {
"command": "uv",
"args": ["run", "main.py"],
"cwd": "/path/to/google_workspace_mcp"
}
}
}
If you need to use HTTP mode with Claude Desktop:
{
"mcpServers": {
"google_workspace": {
"command": "npx",
"args": ["mcp-remote", "http://localhost:8000/mcp"]
}
}
}
Note: Make sure to start the server with --transport streamable-http
when using HTTP mode.
The server features transport-aware OAuth callback handling:
http://localhost:8000/oauth2callback
for consistencyWhen calling a tool:
Note: All tools support automatic authentication via
@require_google_service()
decorators with 30-minute service caching.
calendar_tools.py
)Tool | Description |
---|---|
list_calendars | List accessible calendars |
get_events | Retrieve events with time range filtering |
get_event | Fetch detailed information of a single event by ID |
create_event | Create events (all-day or timed) with optional Drive file attachments |
modify_event | Update existing events |
delete_event | Remove events |
drive_tools.py
)Tool | Description |
---|---|
search_drive_files | Search files with query syntax |
get_drive_file_content | Read file content (supports Office formats) |
list_drive_items | List folder contents |
create_drive_file | Create new files or fetch content from public URLs |
gmail_tools.py
)Tool | Description |
---|---|
search_gmail_messages | Search with Gmail operators |
get_gmail_message_content | Retrieve message content |
send_gmail_message | Send emails |
draft_gmail_message | Create drafts |
docs_tools.py
)Tool | Description |
---|---|
search_docs | Find documents by name |
get_doc_content | Extract document text |
list_docs_in_folder | List docs in folder |
create_doc | Create new documents |
sheets_tools.py
)Tool | Description |
---|---|
list_spreadsheets | List accessible spreadsheets |
get_spreadsheet_info | Get spreadsheet metadata |
read_sheet_values | Read cell ranges |
modify_sheet_values | Write/update/clear cells |
create_spreadsheet | Create new spreadsheets |
create_sheet | Add sheets to existing files |
forms_tools.py
)Tool | Description |
---|---|
create_form | Create new forms with title and description |
get_form | Retrieve form details, questions, and URLs |
set_publish_settings | Configure form template and authentication settings |
get_form_response | Get individual form response details |
list_form_responses | List all responses to a form with pagination |
chat_tools.py
)Tool | Description |
---|---|
list_spaces | List chat spaces/rooms |
get_messages | Retrieve space messages |
send_message | Send messages to spaces |
search_messages | Search across chat history |
google_workspace_mcp/
├── auth/ # Authentication system with decorators
├── core/ # MCP server and utilities
├── g{service}/ # Service-specific tools
├── main.py # Server entry point
├── client_secret.json # OAuth credentials (not committed)
└── pyproject.toml # Dependencies
from auth.service_decorator import require_google_service
@require_google_service("drive", "drive_read") # Service + scope group
async def your_new_tool(service, param1: str, param2: int = 10):
"""Tool description"""
# service is automatically injected and cached
result = service.files().list().execute()
return result # Return native Python objects
SCOPE_GROUPS
for easy maintenance@require_multiple_services()
for complex toolsclient_secret.json
or .credentials/
directoryhttp://localhost:8000/oauth2callback
for development (requires OAUTHLIB_INSECURE_TRANSPORT=1
)mcpo
over networksTo use this server as a tool provider within Open WebUI:
Create a file named config.json
with the following structure to have mcpo
make the streamable HTTP endpoint available as an OpenAPI spec tool:
{
"mcpServers": {
"google_workspace": {
"type": "streamablehttp",
"url": "http://localhost:8000/mcp"
}
}
}
mcpo --port 8001 --config config.json --api-key "your-optional-secret-key"
This command starts the mcpo
proxy, serving your active (assuming port 8000) Google Workspace MCP on port 8001.
http://localhost:8001/google_workspace
(matching the mcpo base URL and server name from config.json)--api-key
with mcpo, enter it as the API KeyThe Google Workspace tools should now be available when interacting with models in Open WebUI.
MIT License - see LICENSE
file for details.
{ "mcpServers": { "googleworkspacemcp": { "command": "uvx", "args": [ "workspace-mcp" ] } } }
Related projects feature coming soon
Will recommend related projects based on sub-categories