Documentation

Enable with MCP_ENABLE_OAUTH21=true and run HTTP transport (--transport streamable-http). This is the recommended mode for modern MCP clients and bearer-token auth.

Default mode when OAuth 2.1 is not enabled. Use this for older clients that do not support OAuth 2.1. --single-user cannot be combined with OAuth 2.1.

Container-friendly mode with no filesystem writes. Requires OAuth 2.1 and bearer tokens on requests.

Use when your app handles OAuth externally. The server skips local OAuth flow and validates incoming bearer tokens.

Select proxy storage backend for OAuth state in distributed deployments.

Authenticate as a service account and impersonate domain users. When a tool call supplies user_google_email, it is used as the per-request impersonation subject, so one server instance can act for multiple domain users; USER_GOOGLE_EMAIL is the fallback subject.

Customize the OAuth 2.1 consent page shown to users during authorization.

Run with --transport streamable-http for Claude Code, VS Code MCP, MCP Inspector, and OAuth 2.1 support.

Use only for clients with incomplete MCP support. Not recommended for modern multi-user flows.

Directly list and invoke tools from the command line without running the full MCP server process.

Three cumulative tiers for simplified deployments: core, extended, complete.

--read-only requests readonly scopes and hides write tools. --permissions enables per-service permission levels.

Use external URL overrides when running behind a reverse proxy so generated OAuth endpoints match public domains.

Downloaded Gmail/Drive attachments are stored in persistent local storage and exposed by URL in HTTP mode.

Distributed tracing via the otel extra (pip install "workspace-mcp[otel]", included in the Docker image). Tracing is fully disabled unless an OTLP endpoint is configured; spans export only to the collector you specify. Standard OTLP variables for headers, TLS, sampling, and batching are honored.

Server debug logs are written to a configurable directory.

Lists calendars accessible to the authenticated user.

Retrieves events for a calendar and time range.

Consolidated create, update, and delete event operations.

Create a new secondary Google Calendar.

Query free/busy information across one or more calendars.

Create, list, update, or delete Out of Office events.

Create, list, update, or delete Focus Time events.

Search Drive files and folders.

Read file content with export support.

Download Drive files via local path or HTTP attachment URL.

Create files from inline content or source URLs.

Create folders in My Drive or shared drives.

Import files (Markdown, DOCX, HTML, etc.) into Google Docs.

Import presentation files (PPTX, PPT, ODP) as Google Slides.

Import spreadsheet files (XLSX, CSV, TSV, etc.) as Google Sheets.

Generate shareable links for files.

List folder contents or shared drives.

Copy existing Drive files with optional renaming.

Update metadata, move files, or replace Google Apps content in place.

Grant, update, revoke permissions, and transfer ownership.

Configure link sharing and file-level sharing.

Get file metadata, parents, and detailed permission entries.

Check whether a file is publicly accessible.

Search mail using Gmail query operators.

Retrieve message content. With full=True, returns the complete untruncated message via file/URL (or inline when no file storage is available).

Batch fetch message content.

Send email messages (supports replies and attachments).

Retrieve full thread content.

Download Gmail attachments to persistent attachment storage.

Add/remove labels on a message.

List account labels.

List configured Gmail filters.

Create/update/delete labels.

Create/delete Gmail filters.

Create Gmail drafts.

Batch fetch thread content.

Batch label modifications.

Legacy OAuth 2.0 auth helper (disabled with OAuth 2.1).

Extract plain text document content.

Create new documents.

Modify document text with formatting and links.

Search docs by name.

Find and replace text.

List docs in a Drive folder.

Insert tables, lists, and page breaks.

Apply heading and paragraph styles, including nested lists.

Export a document as formatted Markdown.

Export a doc to PDF.

List all document comments.

Create, reply, or resolve comments.

Insert images from Drive or URLs.

Update headers and footers.

Execute multiple doc operations in one call.

Inspect structural document elements.

Create populated tables.

Debug table structures.

Create, rename, delete, or populate document tabs from markdown.

Read values from ranges.

Write, update, and clear range values.

Create spreadsheets.

List available spreadsheets.

Read spreadsheet metadata and sheet info.

Apply styling and number/text formats to ranges.

List structured tables with IDs, names, ranges, and columns.

Add sheets to existing spreadsheets.

Append rows to a structured table, auto-extending the table range.

Move rows between sheets within a spreadsheet.

Resize, hide, freeze, insert, or delete rows and columns.

List comments on spreadsheets.

Create, reply, and resolve spreadsheet comments.

Add, update, and remove conditional formatting rules.

Create presentations.

Retrieve presentation details.

Apply multiple slide updates in one request.

Retrieve a specific page/slide.

Generate slide thumbnails.

List all presentation comments.

Create, reply, and resolve presentation comments.

Create forms.

Retrieve form metadata and URLs.

List responses with pagination.

Configure publish and auth settings.

Retrieve an individual response.

Apply batch updates to form structure/settings.

List tasks with filters.

Retrieve task details.

Consolidated create, update, delete, and move task operations.

List task lists.

Retrieve task-list details.

Consolidated create/update/delete/clear-completed for task lists.

Search by name, email, and phone.

Retrieve detailed contact profiles.

List contacts with pagination.

Create, update, or delete contacts.

List contact groups.

Retrieve group details and members.

Batch create, update, or delete contacts.

Create, update, delete groups, and manage membership.

Retrieve messages in a space.

Send messages to spaces.

Search chat history.

Add emoji reactions to messages.

List spaces and DMs.

Download chat attachments.

Run custom search queries with optional site restrictions.

Retrieve search engine configuration metadata.

List available script projects.

Retrieve full project structure and files.

Read a script file from a project.

Create standalone or bound script projects.

Create or update script files.

Execute deployed script functions with args.

Generate Apps Script code for time-driven and event triggers.

List deployments for a project.

Create, update, or delete deployments.

List saved versions of a script project.

Create an immutable version from the current project state.

Retrieve details for a specific version.

Permanently delete a script project (cannot be undone).

Inspect recent executions and status.

Retrieve execution metrics for a script project.