Which integrations are available for this server?

Provides tools for listing, creating, moving, renaming, copying, trashing, and sharing files in Google Drive. Provides tools for reading, sending, and managing emails via Gmail API through workspace-cli server. Provides tools for managing Google Cloud resources including Cloud Run, IAM, Storage, Logging, and BigQuery via gcp-cli server. Provides tools for reading, writing, and formatting documents, including text extraction, search, insert, style updates, and find/replace. Provides tools for creating, reading, and modifying presentations, including slide management, text formatting, speaker notes, and branded content creation.

How do I use Vopak Workspace MCP?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Vopak Workspace MCP create a new Google Doc titled 'Project Plan' and add a heading and bullet list" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Vopak Workspace MCP

by patriciosantamaria

Overview Schema Source Related Servers Discussions Admin

Python

Remote

Vopak MCP

What Is This?

Vopak MCP is a collection of custom Model Context Protocol servers that give AI coding agents full, safe access to Google Workspace and Google Cloud Platform. It runs as a single Docker container and exposes 3 independent MCP servers:

Server	Tools	Auth	Purpose
`workspace-tools`	36	ADC	Granular Slides, Docs, Sheets, Drive, and branded content tools
`workspace-cli`	3	OAuth	GWS CLI wrappers for Gmail, Calendar, Tasks, Forms, People
`gcp-cli`	3	ADC	GCP CLI wrappers for Cloud Run, IAM, Storage, Logging, BigQuery, and more

You choose what to install. Each server is independently configurable. Install all 3 for full coverage, or just the ones you need.

Related MCP server: google-connections-mcp

Architecture

graph TB
    subgraph Agent["AI Agent (Antigravity / Gemini)"]
        direction LR
        A1["workspace-tools<br/><small>36 tools</small>"]
        A2["workspace-cli<br/><small>3 tools</small>"]
        A3["gcp-cli<br/><small>3 tools</small>"]
    end

    subgraph Docker["Docker Container: vopak-mcp"]
        direction TB
        S1["workspace_tools.py<br/><small>Slides, Docs, Sheets, Drive, Branded</small>"]
        S2["workspace_cli.py<br/><small>gws_read / gws_write / gws_destructive</small>"]
        S3["gcp_cli_server.py<br/><small>gcp_read / gcp_write / gcp_destructive</small>"]
    end

    subgraph APIs["Google APIs"]
        direction LR
        WS["Workspace APIs<br/><small>Slides, Docs, Sheets, Drive</small>"]
        CLI["GWS CLI<br/><small>Gmail, Calendar, Tasks, Forms</small>"]
        GCP["GCP CLI<br/><small>gcloud, bq, gsutil</small>"]
    end

    A1 -->|stdio| S1
    A2 -->|stdio| S2
    A3 -->|stdio| S3

    S1 -->|OAuth/ADC| WS
    S2 -->|OAuth| CLI
    S3 -->|ADC| GCP

    style Docker fill:#0a2373,stroke:#00cfe1,color:#fff
    style Agent fill:#1a1a2e,stroke:#283ce1,color:#fff
    style APIs fill:#16213e,stroke:#00cfe1,color:#fff

Quick Start

1. Clone and Build

git clone https://github.com/patriciosantamaria/vopak-mcp.git
cd vopak-mcp
docker compose up -d --build

2. Authenticate

# Google Workspace CLI (OAuth — for workspace-cli server)
docker exec -it vopak-mcp gws auth setup

# GCP (Application Default Credentials — for workspace-tools and gcp-cli)
docker exec -it vopak-mcp gcloud auth application-default login

3. Verify

docker exec -it vopak-mcp python -m src.servers.workspace_tools   # Should print server info
docker exec -it vopak-mcp python -m src.servers.workspace_cli     # Should print server info
docker exec -it vopak-mcp python -m src.servers.gcp_cli_server    # Should print server info

4. Configure Your IDE

Copy the MCP config into your Antigravity (or other MCP client) configuration:

{
  "mcpServers": {
    "workspace-tools": {
      "command": "docker",
      "args": ["exec", "-i", "vopak-mcp", "python", "-m", "src.servers.workspace_tools"],
      "timeout": 30
    },
    "workspace-cli": {
      "command": "docker",
      "args": ["exec", "-i", "vopak-mcp", "python", "-m", "src.servers.workspace_cli"],
      "timeout": 30
    },
    "gcp-cli": {
      "command": "docker",
      "args": ["exec", "-i", "vopak-mcp", "python", "-m", "src.servers.gcp_cli_server"],
      "timeout": 60
    }
  }
}

See mcp_config.example.json for the full reference.

Setup Options

Not every project needs all 42 tools. Choose the setup that fits your use case:

Setup	Servers	Tools	Best For
Full	`workspace-tools` + `workspace-cli` + `gcp-cli`	42	Full-stack projects using Workspace + GCP
Workspace Only	`workspace-tools` + `workspace-cli`	39	Projects that only use Google Workspace
Workspace Granular	`workspace-tools` only	36	Slides/Docs/Sheets/Drive automation (no Gmail/Calendar)
GCP Only	`gcp-cli` only	3	Infrastructure management, Cloud Run, BigQuery
CLI Only	`workspace-cli` + `gcp-cli`	6	Universal CLI access to both Workspace and GCP

Complete Tool Catalog

Server 1: `workspace-tools` (36 tools)

Granular, purpose-built tools for Google Slides, Docs, Sheets, Drive, and branded content creation.

Slides Tools (19)

#	Tool	Type	Description
1	`slides_get_presentation`	Read	Presentation metadata: slide count, IDs, titles, page dimensions
2	`slides_get_slide_content`	Read	All elements from a slide with text, positions, placeholder types
3	`slides_get_speaker_notes`	Read	Speaker notes from one or all slides with element IDs
4	`slides_get_element_styles`	Read	Per-run font, bold, italic, color, links for all text elements
5	`slides_get_comments`	Read	All comments with authors, replies, resolution status
6	`slides_search_text`	Read	Full-text search across all slides with context snippets
7	`slides_measure_text_bounds`	Read	Estimate text overflow using font-metric heuristics
8	`slides_audit_deck`	Read	Batch audit: titles, text, overflow, thumbnails in one call
9	`slides_get_thumbnail`	Read	PNG thumbnail URL for visual QA verification
10	`slides_update_text`	Write	Replace text in a specific element
11	`slides_format_text`	Write	Apply formatting (bold, font, color) to text ranges
12	`slides_update_and_format_text`	Write	Replace text and apply formatting in one atomic call
13	`slides_duplicate_slide`	Write	Clone a slide at a specified position
14	`slides_reorder_slides`	Write	Move slides to new positions
15	`slides_update_speaker_notes`	Write	Replace speaker notes on a single slide
16	`slides_bulk_update_speaker_notes`	Write	Update speaker notes on multiple slides in one call
17	`slides_batch_update`	Write	Raw Slides API batch update (escape hatch)
18	`slides_delete_slide`	Destructive	Permanently delete a slide
19	`slides_remove_speaker_notes`	Destructive	Clear speaker notes from a slide

Docs Tools (8)

#	Tool	Type	Description
20	`docs_get_structure`	Read	Document structure: headings, sections, element tree
21	`docs_read_text`	Read	Extract plain text from a document
22	`docs_search_text`	Read	Search for text patterns across the document
23	`docs_insert_text`	Write	Insert text at a specific position
24	`docs_update_style`	Write	Apply formatting to text ranges
25	`docs_append_section`	Write	Append a new section with heading and body
26	`docs_find_and_replace`	Write	Find and replace text across the document
27	`docs_delete_text`	Destructive	Delete text at a specific range

Sheets Tools (4)

#	Tool	Type	Description
28	`sheets_read_range`	Read	Read cell values from a specified range
29	`sheets_get_structure`	Read	Sheet names, row/column counts, named ranges
30	`sheets_write_from_file`	Write	Bulk write data from JSON to a sheet range
31	`sheets_verify_range`	Write	Atomic write + readback verification (cell-by-cell)

Drive Tools (2)

#	Tool	Type	Description
32	`drive_list_files`	Read	List files with structured filters (folder, MIME type, name)
33	`drive_manage_file`	Write	Create, move, rename, copy, trash, or share Drive files

Branded Content Tools (3)

#	Tool	Type	Description
34	`create_vopak_presentation`	Write	Generate pixel-perfect Vopak-branded Google Slides
35	`create_vopak_document`	Write	Generate branded Google Docs from Markdown
36	`docker_health_check`	Read	Environment, credentials, and dependency verification

Server 2: `workspace-cli` (3 tools)

Universal CLI wrappers for the Google Workspace CLI. Covers Gmail, Calendar, Tasks, Forms, People — anything the granular tools above don't cover.

#	Tool	Type	Description
37	`gws_read`	Read	Read-only GWS CLI commands: `list`, `get`, `query`, `export`
38	`gws_write`	Write	Write GWS CLI commands: `create`, `update`, `send`. Requires `reason`
39	`gws_destructive`	Destructive	Delete GWS CLI commands: `delete`, `trash`. Requires `reason` + HITL

How verb-gating works: The server extracts the verb from each command and blocks misrouted operations at the server level. If you try to run a delete command via gws_read, the server rejects it before execution.

When to use: Use workspace-cli for Google Workspace services not covered by the granular workspace-tools server (e.g., Gmail, Calendar, Tasks, Forms). If you install only the CLI, consider loading the GWS CLI Reference Skill for command syntax guidance.

Server 3: `gcp-cli` (3 tools)

Universal CLI wrappers for gcloud, bq, and gsutil. Covers Cloud Run, IAM, Secret Manager, Cloud Storage, Cloud Logging, BigQuery, Pub/Sub, Firestore, Compute, and more.

#	Tool	Type	Description
40	`gcp_read`	Read	Read-only GCP commands: `list`, `describe`, `get`, `show`, `ls`, `cat`
41	`gcp_write`	Write	Write GCP commands: `create`, `deploy`, `update`, `enable`, `cp`. Requires `reason`
42	`gcp_destructive`	Destructive	Delete GCP commands: `delete`, `rm`, `destroy`. Requires `reason` + HITL

Security features:

Verb-gating: Server-side verb classification blocks misrouted operations
Shell injection blocking: Commands are sanitized to block |, &&, ;, backticks, $(), redirects
JSON enforcement: --format=json is auto-appended for structured output
Audit trail: Write and destructive tools require a reason parameter (min 10 chars)

Reference skill: Load skills/gcp_cli_reference/SKILL.md for exact command syntax across 12 GCP services.

Skills

The project includes reference skills that teach agents how to use the CLI tools effectively:

Skill	File	Purpose
GCP CLI Reference	`skills/gcp_cli_reference/SKILL.md`	Command syntax for 12 GCP services: Cloud Run, IAM, Secrets, Storage, Logging, BigQuery, Pub/Sub, Firestore, Compute, APIs, Projects

Security Model

Verb-Gated CLI Tools

Both CLI servers (workspace-cli and gcp-cli) enforce a 3-tier safety model:

READ  ───── Safe. No confirmation needed.
WRITE ───── Requires reason (audit trail). IDE may prompt.
DESTRUCTIVE ─ Requires reason + explicit human confirmation (HITL).

The agent cannot bypass this — verb classification happens server-side before the command reaches the CLI.

Shell Injection Protection (gcp-cli)

All GCP CLI commands are sanitized before execution. The following patterns are blocked:

Pattern	Example	Status
Pipe	`list \| grep`	Blocked
Command chaining	`list && rm`	Blocked
Semicolons	`list; rm`	Blocked
Backticks	`whoami`	Blocked
Subshell	`$(command)`	Blocked
Redirects	`> /etc/passwd`	Blocked

Scoped Authentication

Server	Auth Method	Scopes
`workspace-tools`	Application Default Credentials	Per-tool minimum OAuth scopes
`workspace-cli`	GWS CLI OAuth	Full Workspace access via CLI
`gcp-cli`	Application Default Credentials	Full GCP access via CLI

Development

Prerequisites

Python 3.11+
Docker and Docker Compose

Install for Development

pip install -e ".[dev]"

Run Tests

pytest -v

Lint

ruff check src/ tests/

Project Structure

vopak-mcp/
  src/
    servers/
      workspace_tools.py     # Server 1: 36 granular Workspace tools
      workspace_cli.py       # Server 2: 3 GWS CLI wrappers
      gcp_cli_server.py      # Server 3: 3 GCP CLI wrappers
    tools/
      slides.py              # 19 Slides tools
      docs.py                # 8 Docs tools
      sheets.py              # 4 Sheets tools
      drive.py               # 2 Drive tools
      branded.py             # 3 Branded content tools
      cli_wrapper.py         # 3 GWS CLI wrapper tools
      gcp_cli.py             # 3 GCP CLI wrapper tools
    shared/
      common.py              # AgentResult, safe_execute, auth, API factories
      gws_helpers.py         # GWS verb sets, extraction, query builders
      gws_runner.py          # GWS CLI async subprocess runner
      gcp_helpers.py         # GCP verb sets, extraction, sanitization
      gcp_runner.py          # GCP CLI async subprocess runner
  skills/
    gcp_cli_reference/       # GCP CLI command syntax reference
  tests/
    test_gcp_helpers.py      # GCP helpers unit tests
    test_gcp_cli.py          # GCP CLI tool verb-gating tests
  docs/
    assets/
      hero.png               # Hero graphic
  docker-compose.yml         # Single-container deployment
  Dockerfile                 # Python + gcloud + gws CLI
  pyproject.toml             # Project metadata and dependencies
  mcp_config.example.json    # IDE configuration reference

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessSyncing

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

Clearly AOAuth
sh.clearly
Your workspace as agent tools — docs, canvases, slides, sheets, projects, tickets, and a shell.
Workplace & Productivity Project Management Command Line
31
FGAC.ai: Multiple Gmail Accounts, Google Sheets & DocsOAuth
ai.fgac
Multiple Gmail accounts, editable Google Sheets & Docs for AI agents. Deny-by-default access rules.
Email Workplace & Productivity Security
1
developer-tools A
goog.workspace-developer
Provides tools for searching Google Workspace documentation and much more.
Developer Tools Documentation Access Search
22
mcp-serverOAuth
com.make
Give your AI agents the tools to build, manage, and run automation workflows.
App Automation Developer Tools Workplace & Productivity
2

Related MCP Servers

Google Workspace MCP Server
Workplace & Productivity App Automation Communication
ZatesloFL
A
license
B
quality
D
maintenance
Provides comprehensive natural language control over Google Workspace services including Gmail, Drive, Calendar, Docs, Sheets, Slides, Forms, Tasks, and Chat. Features multi-user OAuth 2.1 support, flexible tool tiers, and seamless integration with AI assistants.
Updated a year ago (2025-09-20 21:13 UTC)
84
3
MIT
google-connections-mcp
Workplace & Productivity Cloud Storage Email
michaelzrork
F
license
Not graded
quality
D
maintenance
Provides AI assistants with access to Google Workspace APIs including Sheets, Calendar, Gmail, Tasks, Drive, and Docs. Enables full CRUD operations and management of Google services through natural language.
Updated 2 months ago (2026-07-10 06:50 UTC)
1
-
Google Workspace MCP Server
Workplace & Productivity Cloud Platforms
takiguchi-yu
A
license
Not graded
quality
A
maintenance
Enables AI assistants to control Google Workspace services (Slides, Sheets, Drive) through natural language.
Updated 15 days ago (2026-08-29 10:56 UTC)
142 npm
ISC
Google Workspace MCP Server
Workplace & Productivity Communication Calendar Management
gemini-cli-extensions
A
license
Not graded
quality
B
maintenance
Enables management of Google Workspace apps (Docs, Sheets, Gmail, Calendar, Drive) from the command line via Gemini CLI.
Updated 9 hours ago (2026-09-13 09:45 UTC)
638
Apache 2.0

Vopak MCP

What Is This?

Architecture

Quick Start

1. Clone and Build

2. Authenticate

3. Verify

4. Configure Your IDE

Setup Options

Complete Tool Catalog

Server 1: workspace-tools (36 tools)

Slides Tools (19)

Docs Tools (8)

Sheets Tools (4)

Drive Tools (2)

Branded Content Tools (3)

Server 2: workspace-cli (3 tools)

Server 3: gcp-cli (3 tools)

Skills

Security Model

Verb-Gated CLI Tools

Shell Injection Protection (gcp-cli)

Scoped Authentication

Development

Prerequisites

Install for Development

Run Tests

Lint

Project Structure

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Google Workspace MCP Server

google-connections-mcp

Google Workspace MCP Server

Google Workspace MCP Server

Server 1: `workspace-tools` (36 tools)

Server 2: `workspace-cli` (3 tools)

Server 3: `gcp-cli` (3 tools)