# 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 one-click install. 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

- One-click: Download the `.dxt` file from GitHub releases and double-click to install into Claude Desktop
- 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
- [Full API Documentation](https://workspacemcp.com/docs): Complete tool reference for all 12 services with parameters
- [Main Repository](https://github.com/taylorwilsdon/google_workspace_mcp): Source code and development

## Installation

- [Latest Release - Desktop Extension (.dxt)](https://github.com/taylorwilsdon/google_workspace_mcp/releases): One-click install for Claude Desktop
- [PyPI Package](https://pypi.org/project/workspace-mcp): Install via pip/uvx
- [Docker Image](https://github.com/taylorwilsdon/google_workspace_mcp/blob/main/Dockerfile): Containerized deployment

## Services (12)

- [Gmail Tools](https://workspacemcp.com/docs#gmail): Search, read, send, draft, label, filter, batch operations, attachments (14 tools)
- [Google Drive Tools](https://workspacemcp.com/docs#google-drive): Search, read, create, copy, update, permissions, access management (14 tools)
- [Google Docs Tools](https://workspacemcp.com/docs#google-docs): Content, create, modify, search, find/replace, formatting, export, images, comments (18 tools)
- [Google Sheets Tools](https://workspacemcp.com/docs#google-sheets): Read, modify, create, format, comments, conditional formatting (11 tools)
- [Google Slides Tools](https://workspacemcp.com/docs#google-slides): Create, get, batch update, thumbnails, comments (7 tools)
- [Google Calendar Tools](https://workspacemcp.com/docs#google-calendar): List calendars, get events, manage events (3 tools)
- [Google Forms Tools](https://workspacemcp.com/docs#google-forms): Create, get, list responses, publish settings, batch update (6 tools)
- [Google Tasks Tools](https://workspacemcp.com/docs#google-tasks): List, get, manage tasks and task lists (6 tools)
- [Google Chat Tools](https://workspacemcp.com/docs#google-chat): Messages, send, search, reactions, list spaces, attachments (6 tools)
- [Google Contacts Tools](https://workspacemcp.com/docs#google-contacts): Search, get, list, manage contacts and groups (8 tools)
- [Google Apps Script Tools](https://workspacemcp.com/docs#google-apps-script): List, get, create, update, run, deployments, processes (8 tools)
- [Google Custom Search Tools](https://workspacemcp.com/docs#google-custom-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
- One-click DXT install for Claude Desktop
- Per-service tool selection for fine-grained control

## 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