← Back to directory

Google Workspace MCP

Community

Control Google Workspace with natural language.

GitHub source repository ↗

★ 2.9k Stars Category · Collaboration Very popular

56FMRS · C

Reliability

8/20

Security and permissions

10/20

Maintenance

12/20

Documentation

14/20

Setup experience

12/20

Based on the supplied repository material and server.json, this is an active third-party Google Workspace MCP server, version 1.22.2, distributed as the workspace-mcp PyPI package with stdio and streamable HTTP transports. It offers broad coverage, self-hosting, and an MIT license, but requires user-managed Google Cloud, OAuth, and API configuration; Google Chat has additional account and app-configuration requirements.

Read the FMRS scoring method →

Google Workspace MCP Server is an MIT-licensed open-source MCP server and CLI tool that exposes Gmail, Drive, Calendar, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat, Apps Script, and Custom Search through Google APIs. It supports progressive tool tiers, service selection, read-only mode, granular permissions, OAuth 2.0/2.1, and stateless operation for multi-user deployments.

Tools

search_gmail_messages

Search Gmail messages using Gmail query operators.

send_gmail_message

Send email messages with attachment support.

get_events

Retrieve calendar events with time-range filtering.

manage_event

Create, update, or delete calendar events.

search_drive_files

Search Drive files using query syntax.

get_drive_file_content

Read Office, PDF, and image file content.

create_drive_file

Create files or fetch files from URLs.

manage_drive_access

Grant, update, revoke permissions, or transfer ownership.

get_doc_content

Extract text from Google Docs.

create_doc

Create new documents.

modify_doc_text

Insert, replace, and format document text.

read_sheet_values

Read spreadsheet cell ranges.

modify_sheet_values

Write, update, or clear cells.

create_spreadsheet

Create new spreadsheets.

format_sheet_range

Apply cell colors, number formats, alignment, and font styles.

create_presentation

Create new presentations.

get_presentation

Retrieve presentation details.

create_form

Create new forms.

list_form_responses

List form responses with pagination.

list_tasks

List tasks with filtering.

manage_task

Create, update, delete, or move tasks.

search_contacts

Search contacts by name, email, or phone.

manage_contact

Create, update, or delete contacts.

get_messages

Retrieve messages from Google Chat spaces.

send_message

Send messages to Chat spaces.

search_messages

Search Chat history.

search_custom

Perform web searches through Google Programmable Search Engine.

list_script_projects

List accessible Apps Script projects.

run_script_function

Execute an Apps Script function with parameters.

Setup

You need Python 3.10+, uv/uvx, and OAuth 2.0 credentials in a Google Cloud project. Set GOOGLE_OAUTH_CLIENT_ID; confidential clients also set GOOGLE_OAUTH_CLIENT_SECRET. Run uvx workspace-mcp for stdio, or uvx workspace-mcp --transport streamable-http for the recommended HTTP mode. Modern clients should use streamable HTTP with OAuth 2.1; Claude Desktop can also connect through a Connector. Enable the required Google APIs and configure a Chat app separately; Chat requires a Google Workspace account.

claude_desktop_config.json

{"mcpServers":{"google_workspace":{"command":"uvx","args":["workspace-mcp"],"env":{"GOOGLE_OAUTH_CLIENT_ID":"your-client-id","GOOGLE_OAUTH_CLIENT_SECRET":"your-secret","OAUTHLIB_INSECURE_TRANSPORT":"1"}}}}

Generate and validate client config

Fit and risk

Best for

Individuals and teams needing access to several Google Workspace services.
Developers deploying by tool tier, service, or permission scope.
Organizations needing self-hosted, multi-user OAuth 2.1, or container deployments.
Developers who want to call MCP tools through a CLI.

Not for

Users requiring a server maintained by Google.
Users with only a personal @gmail.com account who need Google Chat.
Users unwilling to configure Google Cloud OAuth credentials or APIs.
Applications seeking unauthorized access to Google Workspace data.

Required permissions

Requires Google Cloud OAuth client credentials.
OAuth scopes depend on the enabled services and tools.
Supports read-only scopes, per-service granular permissions, and full access.
Write tools for Drive, Gmail, and other services require corresponding write permissions.
Google Chat requires a configured Chat app and a Google Workspace account.
Optional service-account mode requires service-account credentials and domain-wide delegation.

Risks and side effects

Full tools and write scopes may allow modifying, sending, deleting, or sharing user data.
For public deployments, unrestricted dynamic-client redirect URIs can create a phishing risk.
Stdio is a legacy fallback; OAuth 2.1 is recommended for remote or shared deployments.
Local attachments and credential stores write to configured local directories; stateless mode avoids file writes.
Google API quotas, OAuth consent configuration, and account permissions may limit functionality.
The Chat API is unavailable for personal Gmail accounts.

Troubleshooting

Confirm Python 3.10+ and uv/uvx are installed.
Check the OAuth client ID, client secret, redirect URI, and OAUTHLIB_INSECURE_TRANSPORT for development.
Confirm that the required Google APIs are enabled in the Google Cloud project.
If Chat tools fail, verify the Chat app name, avatar URL, and description, and use a Workspace account.
Prefer --transport streamable-http for modern clients; OAuth 2.1 cannot be combined with --single-user or service-account mode.
For remote servers, send Base64 attachment content instead of relying on a client-local file path.

Use cases

Search and process Gmail messages.

Manage calendar events and free/busy information.

Read and write Drive files, Docs, Sheets, and Slides.

Create and manage Forms, Tasks, Contacts, and Chat content.

Run cross-application automation through Apps Script.

Perform configurable web searches with Custom Search.

Supported clients

Claude DesktopFull support

Claude CodeFull support

VS CodeFull support

LM StudioFull support

Related MCP servers

Compare with other MCP servers