# Google Workspace MCP Server

> The most feature-complete Google Workspace MCP server — 12 services, 100+ tools, OAuth 2.1 multi-user auth, full CLI, and custom connector support. Open source under MIT license.

The Google Workspace MCP Server connects AI assistants to all major Google Workspace services through the Model Context Protocol (MCP). Built with FastMCP for optimal performance, it supports OAuth 2.1 multi-user authentication, streamable HTTP and stdio transports, pluggable storage backends (Memory, Disk, Valkey/Redis), and stateless container deployments. Works with all free Google accounts and Google Workspace plans.

## Quick Install

- Claude Desktop / web / cowork: Use the custom connector flow — Connectors > Add custom connector > paste your MCP server URL
- Claude Code: `claude mcp add --transport http workspacemcp http://localhost:8000/mcp`
- CLI: `uvx workspace-mcp` (requires Python 3.10+ and uv)
- Docker: Containerized deployment available

## Documentation

- [Quick Start Guide](https://workspacemcp.com/quick-start): Step-by-step installation and setup in 5 steps
- [Guides](https://workspacemcp.com/guides): Client-specific setup articles for Workspace MCP
- [Claude Custom Connector Guide](https://workspacemcp.com/guides/claude-connectors): Connect Workspace MCP Cloud to Claude Desktop, Claude on the web, Claude cowork, and scheduled tasks
- [ChatGPT Developer Mode Guide](https://workspacemcp.com/guides/chatgpt-developer-mode): Connect Workspace MCP to ChatGPT using Developer Mode and a remote MCP server
- [Full API Documentation](https://workspacemcp.com/docs): Complete tool reference for all 12 services with parameters
- [Advanced Deployment](https://workspacemcp.com/docs/deployment): Reverse proxy setup, origin validation, credential store backends (GCS/CMEK), and full environment variable reference
- [FAQ & Client Setup](https://workspacemcp.com/welcome/faq): Claude Desktop connector setup, troubleshooting, and common questions
- [Main Repository](https://github.com/taylorwilsdon/google_workspace_mcp): Source code and development

## Installation

- [PyPI Package](https://pypi.org/project/workspace-mcp): Install via pip/uvx
- [GitHub Releases](https://github.com/taylorwilsdon/google_workspace_mcp/releases): Release bundles including .mcpb for Claude Desktop
- [Docker Image](https://github.com/taylorwilsdon/google_workspace_mcp/blob/main/Dockerfile): Containerized deployment

## Services (12)

- [Gmail MCP](https://workspacemcp.com/gmail): Search, read, send, draft, label, filter, batch operations, attachments (15 tools)
- [Google Drive MCP](https://workspacemcp.com/google-drive): Search, read, create, copy, update, import to Docs/Sheets/Slides, permissions, access management (16 tools)
- [Google Docs MCP](https://workspacemcp.com/google-docs): Content, create, modify, search, find/replace, formatting, tabs, export, images, comments (19 tools)
- [Google Sheets MCP](https://workspacemcp.com/google-sheets): Read, modify, create, format, structured tables, resize/freeze dimensions, comments, conditional formatting (14 tools)
- [Google Slides MCP](https://workspacemcp.com/google-slides): Create, get, batch update, thumbnails, comments (7 tools)
- [Google Calendar MCP](https://workspacemcp.com/google-calendar): List calendars, get events, manage events, create calendars, free/busy, Out of Office, Focus Time (7 tools)
- [Google Forms MCP](https://workspacemcp.com/google-forms): Create, get, list responses, publish settings, batch update (6 tools)
- [Google Tasks MCP](https://workspacemcp.com/google-tasks): List, get, manage tasks and task lists (6 tools)
- [Google Chat MCP](https://workspacemcp.com/google-chat): Messages, send, search, reactions, list spaces, attachments (6 tools)
- [Google Contacts MCP](https://workspacemcp.com/google-contacts): Search, get, list, manage contacts and groups (8 tools)
- [Google Apps Script MCP](https://workspacemcp.com/google-apps-script): List, get, create, update, run, versions, deployments, triggers, processes, metrics (15 tools)
- [Google Custom Search MCP](https://workspacemcp.com/google-search): Web search, domain-restricted lookups, engine config (2 tools)

## Key Features

- OAuth 2.1 multi-user authentication with pluggable storage backends
- Three progressive tool tiers: Core, Extended, Complete
- Full CLI mode for Claude Code, Codex, and scripting
- Read-only mode with restricted OAuth scopes
- Streamable HTTP (recommended) and stdio transport support
- Stateless container mode for production deployments
- Custom connector support for Claude Desktop, web, and cowork
- Per-service tool selection for fine-grained control
- Service account mode with domain-wide delegation and per-request user impersonation
- Optional OpenTelemetry tracing (off unless an OTLP endpoint is configured)

## Optional

- [Managed Cloud Hosting](https://workspacemcp.com/workspace-mcp-cloud): Let the maintainers run your deployment
- [Privacy Policy](https://workspacemcp.com/privacy): Privacy and data handling
- [Screenshots Gallery](https://workspacemcp.com/screenshots): Visual examples