Google Workspace

wrxck4stars

MCP server providing Google Workspace tools (Drive, Calendar, Sheets, Docs, Gmail, Chat, Admin) via the gws CLI

1# Google Workspace

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: Apache-2.0
Last checked: 2026-10-27

Stars: 4
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Google Workspace?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Google Workspace need an API key?

No required environment variable is listed on this record.

What transport does Google Workspace use?

Google Workspace runs locally over stdio.

When was Google Workspace last checked?

Last checked 2026-10-27. MCP server providing Google Workspace tools (Drive, Calendar, Sheets, Docs, Gmail, Chat, Admin) via the gws CLI

From the publisher

Documentation

Google Workspace MCP Server

An MCP (Model Context Protocol) server that exposes 28 Google Workspace tools (Drive, Calendar, Sheets, Docs, Gmail, Chat, Admin) by wrapping the gws CLI as a subprocess. No direct API integration — all operations go through the gws binary.

How it works
Tools (28)
Prerequisites
Quick start
What --install does
Configuration
Security
Building from source
Project structure
License

How it works

Claude Code <-> (stdio) <-> google-workspace-mcp.jar
                              |
                         GwsClient (ProcessBuilder)
                              |
                         gws CLI binary (@googleworkspace/cli)
                              |
                         Google Workspace APIs

Each MCP tool call translates arguments into a gws command-line invocation, executes it as a subprocess, and returns the JSON response. Auth is delegated entirely to gws auth. Untrusted content (email bodies, document text, file names) is wrapped with random boundary markers to mitigate prompt injection.

Tools (28)

Drive (6)

Tool	Description	Annotations
`drive_files_list`	List files/folders with optional search query	read-only
`drive_files_get`	Get file metadata by ID	read-only
`drive_files_download`	Download file content to local disk	read-only
`drive_files_upload`	Upload a file to Drive
`drive_files_create_folder`	Create a folder
`drive_files_delete`	Delete a file or folder	destructive

Calendar (4)

Tool	Description	Annotations
`calendar_events_list`	List events with optional time range	read-only
`calendar_events_get`	Get event details by ID	read-only
`calendar_events_create`	Create a calendar event
`calendar_events_delete`	Delete a calendar event	destructive

Sheets (4)

Tool	Description	Annotations
`sheets_list`	List spreadsheets	read-only
`sheets_values_get`	Read a cell range	read-only
`sheets_values_update`	Write to a cell range
`sheets_create`	Create a new spreadsheet

Docs (3)

Tool	Description	Annotations
`docs_get`	Get document content	read-only
`docs_create`	Create a new document
`docs_list`	List documents	read-only

Gmail (5)

Tool	Description	Annotations
`gmail_messages_list`	List/search messages	read-only
`gmail_messages_get`	Read a message by ID	read-only
`gmail_labels_list`	List labels	read-only
`gmail_messages_send`	Send an email
`gmail_drafts_create`	Create a draft email

Chat (3)

Tool	Description	Annotations
`chat_spaces_list`	List Chat spaces	read-only
`chat_messages_list`	List messages in a space	read-only
`chat_messages_create`	Send a message to a space

Admin (3)

Tool	Description	Annotations
`admin_users_list`	List directory users via People API	read-only
`admin_users_get`	Get user details	read-only
`admin_groups_list`	List contact groups	read-only

Prerequisites

Java 21 or later
gws CLI — npm install -g @googleworkspace/cli
Claude Code — install instructions

Quick start

1. Download

Download the latest JAR from Releases:

curl -L -o google-workspace-mcp-1.0.0.jar \
  https://github.com/wrxck/google-workspace-mcp/releases/download/v1.0.0/google-workspace-mcp-1.0.0.jar

2. Install

java -jar google-workspace-mcp-1.0.0.jar --install

This walks you through Google Cloud setup, OAuth login, and registers the MCP server with Claude Code — all in one command.

3. Use

Restart Claude Code, then:

> List my upcoming calendar events for this week
> Download the Q4 report from Drive
> Send an email to [email protected] about the status update
> What spreadsheets do I have?

What `--install` does

The --install flag automates the full setup:

Checks for gws CLI — prints install instructions if missing
Runs gws auth setup — creates a Google Cloud project and enables Workspace APIs (opens browser)
Runs gws auth login — authenticates via OAuth with Drive, Gmail, Calendar, and Chat scopes (opens browser)
Registers with Claude Code — runs claude mcp add to register the server for stdio transport
Installs Claude Code skill — copies a tool reference guide to ~/.claude/skills/gws/SKILL.md so Claude knows how to use the tools effectively

Configuration

Flag	Description
`--install`	Full setup: auth + register with Claude Code + install skill
`--install --claude-binary /path/to/claude`	Install with custom Claude binary path
`--auth`	Re-authenticate only (no setup, no registration)
(no flags)	Start MCP server (normal operation)

Manual registration

If automatic registration fails:

claude mcp add --scope user --transport stdio google-workspace -- \
  java -jar /path/to/google-workspace-mcp-1.0.0.jar

Security

Response sanitization — All API responses containing untrusted content (email bodies, document text, file names, chat messages) are wrapped in unique cryptographic boundary markers. This defends against prompt injection via API responses.
Tool annotations — readOnlyHint and destructiveHint are set accurately per tool, so Claude treats delete operations with appropriate caution.
Command injection prevention — Arguments are passed as a list to ProcessBuilder, never shell-interpolated.
Input validation — Required parameters are validated before subprocess execution.

Building from source

git clone https://github.com/wrxck/google-workspace-mcp.git
cd google-workspace-mcp
mvn clean package

This compiles, runs all tests, and produces the shaded JAR at target/google-workspace-mcp-1.0.0.jar.

Then install:

java -jar target/google-workspace-mcp-1.0.0.jar --install

Project structure

src/main/java/com/google/workspace/mcp/
├── GoogleWorkspaceMcpServer.java  # Entry point, CLI flags, server bootstrap
├── GwsClient.java                 # Subprocess execution, JSON parsing, timeouts
├── GwsAuth.java                   # Auth delegation (gws auth setup/login)
├── ContentSanitizer.java          # Prompt injection defense (boundary markers)
└── tools/
    ├── DriveTools.java            # 6 Drive tools
    ├── CalendarTools.java         # 4 Calendar tools
    ├── SheetsTools.java           # 4 Sheets tools
    ├── DocsTools.java             # 3 Docs tools
    ├── GmailTools.java            # 5 Gmail tools
    ├── ChatTools.java             # 3 Chat tools
    └── AdminTools.java            # 3 Admin tools (People API)

License

Apache License 2.0

Google Workspace

wrxck4stars

MCP server providing Google Workspace tools (Drive, Calendar, Sheets, Docs, Gmail, Chat, Admin) via the gws CLI

Communication Productivity

Install Run on PlugMCP

GitHub

Run on PlugMCP

1# Google Workspace

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: Apache-2.0
Last checked: 2026-10-27

Stars: 4
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Google Workspace?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Google Workspace need an API key?

No required environment variable is listed on this record.

What transport does Google Workspace use?

Google Workspace runs locally over stdio.

When was Google Workspace last checked?

Last checked 2026-10-27. MCP server providing Google Workspace tools (Drive, Calendar, Sheets, Docs, Gmail, Chat, Admin) via the gws CLI

From the publisher

Documentation

How it works

Claude Code <-> (stdio) <-> google-workspace-mcp.jar
                              |
                         GwsClient (ProcessBuilder)
                              |
                         gws CLI binary (@googleworkspace/cli)
                              |
                         Google Workspace APIs

Tools (28)

Drive (6)

Tool	Description	Annotations
`drive_files_list`	List files/folders with optional search query	read-only
`drive_files_get`	Get file metadata by ID	read-only
`drive_files_download`	Download file content to local disk	read-only
`drive_files_upload`	Upload a file to Drive
`drive_files_create_folder`	Create a folder
`drive_files_delete`	Delete a file or folder	destructive

Calendar (4)

Tool	Description	Annotations
`calendar_events_list`	List events with optional time range	read-only
`calendar_events_get`	Get event details by ID	read-only
`calendar_events_create`	Create a calendar event
`calendar_events_delete`	Delete a calendar event	destructive

Sheets (4)

Tool	Description	Annotations
`sheets_list`	List spreadsheets	read-only
`sheets_values_get`	Read a cell range	read-only
`sheets_values_update`	Write to a cell range
`sheets_create`	Create a new spreadsheet

Docs (3)

Tool	Description	Annotations
`docs_get`	Get document content	read-only
`docs_create`	Create a new document
`docs_list`	List documents	read-only

Gmail (5)

Tool	Description	Annotations
`gmail_messages_list`	List/search messages	read-only
`gmail_messages_get`	Read a message by ID	read-only
`gmail_labels_list`	List labels	read-only
`gmail_messages_send`	Send an email
`gmail_drafts_create`	Create a draft email

Chat (3)

Tool	Description	Annotations
`chat_spaces_list`	List Chat spaces	read-only
`chat_messages_list`	List messages in a space	read-only
`chat_messages_create`	Send a message to a space

Admin (3)

Tool	Description	Annotations
`admin_users_list`	List directory users via People API	read-only
`admin_users_get`	Get user details	read-only
`admin_groups_list`	List contact groups	read-only

Prerequisites

Java 21 or later
gws CLI — npm install -g @googleworkspace/cli
Claude Code — install instructions

Quick start

1. Download

Download the latest JAR from Releases:

curl -L -o google-workspace-mcp-1.0.0.jar \
  https://github.com/wrxck/google-workspace-mcp/releases/download/v1.0.0/google-workspace-mcp-1.0.0.jar

2. Install

java -jar google-workspace-mcp-1.0.0.jar --install

This walks you through Google Cloud setup, OAuth login, and registers the MCP server with Claude Code — all in one command.

3. Use

Restart Claude Code, then:

> List my upcoming calendar events for this week
> Download the Q4 report from Drive
> Send an email to [email protected] about the status update
> What spreadsheets do I have?

What `--install` does

The --install flag automates the full setup:

Checks for gws CLI — prints install instructions if missing
Runs gws auth setup — creates a Google Cloud project and enables Workspace APIs (opens browser)
Runs gws auth login — authenticates via OAuth with Drive, Gmail, Calendar, and Chat scopes (opens browser)
Registers with Claude Code — runs claude mcp add to register the server for stdio transport
Installs Claude Code skill — copies a tool reference guide to ~/.claude/skills/gws/SKILL.md so Claude knows how to use the tools effectively

Configuration

Flag	Description
`--install`	Full setup: auth + register with Claude Code + install skill
`--install --claude-binary /path/to/claude`	Install with custom Claude binary path
`--auth`	Re-authenticate only (no setup, no registration)
(no flags)	Start MCP server (normal operation)

Manual registration

If automatic registration fails:

claude mcp add --scope user --transport stdio google-workspace -- \
  java -jar /path/to/google-workspace-mcp-1.0.0.jar

Security

Response sanitization — All API responses containing untrusted content (email bodies, document text, file names, chat messages) are wrapped in unique cryptographic boundary markers. This defends against prompt injection via API responses.
Tool annotations — readOnlyHint and destructiveHint are set accurately per tool, so Claude treats delete operations with appropriate caution.
Command injection prevention — Arguments are passed as a list to ProcessBuilder, never shell-interpolated.
Input validation — Required parameters are validated before subprocess execution.

Building from source

git clone https://github.com/wrxck/google-workspace-mcp.git
cd google-workspace-mcp
mvn clean package

This compiles, runs all tests, and produces the shaded JAR at target/google-workspace-mcp-1.0.0.jar.

Then install:

java -jar target/google-workspace-mcp-1.0.0.jar --install

Project structure

src/main/java/com/google/workspace/mcp/
├── GoogleWorkspaceMcpServer.java  # Entry point, CLI flags, server bootstrap
├── GwsClient.java                 # Subprocess execution, JSON parsing, timeouts
├── GwsAuth.java                   # Auth delegation (gws auth setup/login)
├── ContentSanitizer.java          # Prompt injection defense (boundary markers)
└── tools/
    ├── DriveTools.java            # 6 Drive tools
    ├── CalendarTools.java         # 4 Calendar tools
    ├── SheetsTools.java           # 4 Sheets tools
    ├── DocsTools.java             # 3 Docs tools
    ├── GmailTools.java            # 5 Gmail tools
    ├── ChatTools.java             # 3 Chat tools
    └── AdminTools.java            # 3 Admin tools (People API)

License

Apache License 2.0

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Google Workspace?

Does Google Workspace need an API key?

What transport does Google Workspace use?

When was Google Workspace last checked?

Documentation

Google Workspace MCP Server

Table of contents

How it works

Tools (28)

Drive (6)

Calendar (4)

Sheets (4)

Docs (3)

Gmail (5)

Chat (3)

Admin (3)

Prerequisites

Quick start

1. Download

2. Install

3. Use

What --install does

Configuration

Manual registration

Security

Building from source

Project structure

License

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Google Workspace?

Does Google Workspace need an API key?

What transport does Google Workspace use?

When was Google Workspace last checked?

Documentation

Google Workspace MCP Server

Table of contents

How it works

Tools (28)

Drive (6)

Calendar (4)

Sheets (4)

Docs (3)

Gmail (5)

Chat (3)

Admin (3)

Prerequisites

Quick start

1. Download

2. Install

3. Use

What --install does

Configuration

Manual registration

Security

Building from source

Project structure

License

What `--install` does

What `--install` does