google_workspace_mcp

Overview of google_workspace_mcp

What it is

google_workspace_mcp is a comprehensive MCP (Model Context Protocol) server that provides AI assistants with natural language control over twelve major Google Workspace services including Gmail, Google Calendar, Docs, Sheets, Slides, Chat, Forms, Tasks, Contacts, Drive, Custom Search, and Apps Script. It includes a full featured CLI and Code Mode for use with tools like Claude Code and Codex. The server supports multi-user OAuth 2.1 authentication, stateless deployments, and external auth server & gateway passthrough auth, making it suitable for hosting centrally for an entire organization. It runs locally over stdio for legacy clients and remotely over streamable HTTP. The project is fully open source under the MIT license with no telemetry, usage reporting, or SaaS dependency unless the user configures optional OpenTelemetry support. Every line is auditable in the repository, and credentials never leave the user's environment. The server also includes sensitive path blocking to prevent reading common credential stores even if allowed file directories are broadened.

Key features

• Provides over 120 tools behind a single MCP server covering twelve Google Workspace services * Supports three progressive tool tiers (core, extended, complete), read-only mode, per-service permissions, and cherry-picking specific tools * Includes a CLI (workspace-cli) for listing and calling tools against a running server with encrypted, disk-backed OAuth token caching * Has OAuth 2.1 (PKCE) support with multi-user auth and native credential store backends such as GCS/CMEK * Supports stateless container deployment with zero disk writes for locked-down environments * Can be deployed behind a reverse proxy with origin validation and trusted-gateway identity

Use cases

Connecting AI assistants like Claude Desktop, Claude Code, ChatGPT, VS Code, LM Studio, Open WebUI, and other MCP clients to Google Workspace for tasks such as searching and sending Gmail, managing Calendar events, creating and editing Docs and Sheets, building Forms, managing Tasks and Contacts, controlling Chat messages and spaces, and running Apps Scripts. The CLI enables scripting and automation of these operations. The server can be centrally hosted for an organization with secure multi-user authentication.

Getting started

bash # 1. Credentials export GOOGLE_OAUTH_CLIENT_ID='...' export GOOGLE_OAUTH_CLIENT_SECRET='...' # 2. Launch - pick a tier uvx workspace-mcp --tool-tier core # essential tools uvx workspace-mcp --tool-tier extended # core + management ops uvx workspace-mcp --tool-tier complete # everything # Or cherry-pick services uvx workspace-mcp --tools gmail drive calendar

License and pricing

The project is MIT licensed. The pricing type is open source. A managed cloud instance is available starting at $5/mo as stated in the README.

Based on the project's public README and repository metadata.