productivitycommunication

Google Workspace MCP▌

by taylorwilsdon

Control Gmail, Google Calendar, Docs, Sheets, Slides, Chat, Forms, Tasks, Search, and Drive with AI. Comprehensive Googl

Control Gmail, Google Calendar, Docs, Sheets, Slides, Chat, Forms, Tasks, Search, and Drive with AI. Comprehensive Google Workspace integration for AI assistants. 1,700+ GitHub stars.

github stars

★ 1.7K

GitHub

Remote OAuth2.1 multi-user supportWorks with all Google account types1-click Claude installation

best for

/ Business users automating Google Workspace workflows
/ Teams managing calendars and documents through AI
/ Organizations centralizing Google services access

capabilities

/ Send and manage Gmail messages
/ Create and edit Google Calendar events
/ Read and write Google Docs and Sheets
/ Upload and organize Google Drive files
/ Create Google Forms and Slides
/ Manage Google Tasks and Contacts

what it does

Connects AI assistants to your entire Google Workspace account, letting you manage Gmail, Calendar, Drive, Docs, Sheets and other Google services through natural language commands.

about

Google Workspace MCP is a community-built MCP server published by taylorwilsdon that provides AI assistants with tools and capabilities via the Model Context Protocol. Control Gmail, Google Calendar, Docs, Sheets, Slides, Chat, Forms, Tasks, Search, and Drive with AI. Comprehensive Googl It is categorized under productivity, communication.

how to install

You can install Google Workspace MCP in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

MIT

Google Workspace MCP is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

# Google Workspace MCP Server

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Python 3.10+](https://img.shields.io/badge/Python-3.10%2B-blue.svg)](https://www.python.org/downloads/) [![PyPI](https://img.shields.io/pypi/v/workspace-mcp.svg)](https://pypi.org/project/workspace-mcp/) [![PyPI Downloads](https://static.pepy.tech/personalized-badge/workspace-mcp?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=BLUE&left_text=downloads)](https://pepy.tech/projects/workspace-mcp) [![Website](https://img.shields.io/badge/Website-workspacemcp.com-green.svg)](https://workspacemcp.com) *Full natural language control over Google Calendar, Drive, Gmail, Docs, Sheets, Slides, Forms, Tasks, Contacts, and Chat through all MCP clients, AI assistants and developer tools. Includes a full featured CLI for use with tools like Claude Code and Codex!* **The most feature-complete Google Workspace MCP server**, with Remote OAuth2.1 multi-user support and 1-click Claude installation. With native OAuth 2.1, stateless mode and external auth server support, it's the only Workspace MCP you can host for your whole organization centrally & securely! ###### Support for all free Google accounts (Gmail, Docs, Drive etc) & Google Workspace plans (Starter, Standard, Plus, Enterprise, Non Profit) with expanded app options like Chat & Spaces.

Interested in a private, managed cloud instance? [That can be arranged.](https://workspacemcp.com/workspace-mcp-cloud)

--- **See it in action:**

--- ### A quick plug for AI-Enhanced Docs

◆ But why?

**This README was written with AI assistance, and here's why that matters** > > As a solo dev building open source tools, comprehensive documentation often wouldn't happen without AI help. Using agentic dev tools like **Roo** & **Claude Code** that understand the entire codebase, AI doesn't just regurgitate generic content - it extracts real implementation details and creates accurate, specific documentation. > > In this case, Sonnet 4 took a pass & a human (me) verified them 2/16/26.

## Overview A production-ready MCP server that integrates all major Google Workspace services with AI assistants. It supports both single-user operation and multi-user authentication via OAuth 2.1, making it a powerful backend for custom applications. Built with FastMCP for optimal performance, featuring advanced authentication handling, service caching, and streamlined development patterns. **Simplified Setup**: Now uses Google Desktop OAuth clients - no redirect URIs or port configuration needed! ## Features

**@ Gmail** • **≡ Drive** • **⧖ Calendar** **≡ Docs** - Complete Gmail management, end-to-end coverage - Full calendar management with advanced features - File operations with Office format support - Document creation, editing & comments - Deep, exhaustive support for fine-grained editing --- **≡ Forms** • **@ Chat** • **≡ Sheets** • **≡ Slides** - Form creation, publish settings & response management - Space management & messaging capabilities - Spreadsheet operations with flexible cell management - Presentation creation, updates & content manipulation --- **◆ Apps Script** - Automate cross-application workflows with custom code - Execute existing business logic and custom functions - Manage script projects, deployments & versions - Debug and modify Apps Script code programmatically - Bridge Google Workspace services through automation

**⊠ Authentication & Security** - Advanced OAuth 2.0 & OAuth 2.1 support - Automatic token refresh & session management - Transport-aware callback handling - Multi-user bearer token authentication - Innovative CORS proxy architecture --- **✓ Tasks** • **👤 Contacts** • **◆ Custom Search** - Task & task list management with hierarchy - Contact management via People API with groups - Programmable Search Engine (PSE) integration

--- ## Quick Start

Quick Reference Card - Essential commands & configs at a glance

**Credentials** ```bash export GOOGLE_OAUTH_CLIENT_ID="..." export GOOGLE_OAUTH_CLIENT_SECRET="..." ``` [Full setup →](#credential-configuration)

**Launch Commands** ```bash uvx workspace-mcp --tool-tier core uv run main.py --tools gmail drive ``` [More options →](#start-the-server)

**Tool Tiers** - `core` - Essential tools - `extended` - Core + extras - `complete` - Everything [Details →](#tool-tiers)

#### Required Configuration

Environment Variables _{^{← Click to configure in Claude Desktop}}

**Required** | Variable | Purpose | |----------|---------| | `GOOGLE_OAUTH_CLIENT_ID` | OAuth client ID from Google Cloud | | `GOOGLE_OAUTH_CLIENT_SECRET` | OAuth client secret | | `OAUTHLIB_INSECURE_TRANSPORT=1` | Development only (allows `http://` redirect) |

**Optional** | Variable | Purpose | |----------|---------| | `USER_GOOGLE_EMAIL` | Default email for single-user auth | | `GOOGLE_PSE_API_KEY` | API key for Custom Search | | `GOOGLE_PSE_ENGINE_ID` | Search Engine ID for Custom Search | | `MCP_ENABLE_OAUTH21` | Set to `true` for OAuth 2.1 support | | `EXTERNAL_OAUTH21_PROVIDER` | Set to `true` for external OAuth flow with bearer tokens (requires OAuth 2.1) | | `WORKSPACE_MCP_STATELESS_MODE` | Set to `true` for stateless operation (requires OAuth 2.1) |

Claude Desktop stores these securely in the OS keychain; set them once in the extension pane.

--- ### One-Click Claude Desktop Install (Claude Desktop Only, Stdio, Single User) 1. **Download:** Grab the latest `google_workspace_mcp.dxt` from the “Releases” page 2. **Install:** Double-click the file – Claude Desktop opens and prompts you to **Install** 3. **Configure:** In Claude Desktop → **Settings → Extensions → Google Workspace MCP**, paste your Google OAuth credentials 4. **Use it:** Start a new Claude chat and call any Google Workspace tool > **Why DXT?** > Desktop Extensions (`.dxt`) bundle the server, dependencies, and manifest so users go from download → working MCP in **one click** – no terminal, no JSON editing, no version conflicts.

--- ### Prerequisites - **Python 3.10+** - **[uvx](https://github.com/astral-sh/uv)** (for instant installation) or [uv](https://github.com/astral-sh/uv) (for development) - **Google Cloud Project** with OAuth 2.0 credentials ### Configuration

Google Cloud Setup _{^{← OAuth 2.0 credentials & API enablement}}

1. Create Project ```text console.cloud.google.com → Create new project → Note project name ``` _{[Open Console →](https://console.cloud.google.com/)}	2. OAuth Credentials ```text APIs & Services → Credentials → Create Credentials → OAuth Client ID → Desktop Application ``` _{Download & save credentials}	3. Enable APIs ```text APIs & Services → Library Search & enable: Calendar, Drive, Gmail, Docs, Sheets, Slides, Forms, Tasks, People, Chat, Search ``` _{See quick links below}
OAuth Credential Setup Guide _{^{← Step-by-step instructions}} Complete Setup Process: 1. Create OAuth 2.0 Credentials - Visit [Google Cloud Console](https://console.cloud.google.com/) - Create a new project (or use existing) - Navigate to APIs & Services → Credentials - Click Create Credentials → OAuth Client ID - Choose Desktop Application as the application type (no redirect URIs needed!) - Download credentials and note the Client ID and Client Secret 2. Enable Required APIs - In APIs & Services → Library - Search for and enable each required API - Or use the quick links below for one-click enabling 3. Configure Environment - Set your credentials: ```bash export GOOGLE_OAUTH_CLIENT_ID="your-client-id" export GOOGLE_OAUTH_CLIENT_SECRET="your-secret" ``` [Full Documentation →](https://developers.google.com/workspace/guides/auth-overview)

Quick API Enable Links ---

1. Create Project ```text console.cloud.google.com → Create new project → Note project name ``` _{[Open Console →](https://console.cloud.google.com/)}	2. OAuth Credentials ```text APIs & Services → Credentials → Create Credentials → OAuth Client ID → Desktop Application ``` _{Download & save credentials}	3. Enable APIs ```text APIs & Services → Library Search & enable: Calendar, Drive, Gmail, Docs, Sheets, Slides, Forms, Tasks, People, Chat, Search ``` _{See quick links below}
OAuth Credential Setup Guide _{^{← Step-by-step instructions}} Complete Setup Process: 1. Create OAuth 2.0 Credentials - Visit [Google Cloud Console](https://console.cloud.google.com/) - Create a new project (or use existing) - Navigate to APIs & Services → Credentials - Click Create Credentials → OAuth Client ID - Choose Desktop Application as the application type (no redirect URIs needed!) - Download credentials and note the Client ID and Client Secret 2. Enable Required APIs - In APIs & Services → Library - Search for and enable each required API - Or use the quick links below for one-click enabling 3. Configure Environment - Set your credentials: ```bash export GOOGLE_OAUTH_CLIENT_ID="your-client-id" export GOOGLE_OAUTH_CLIENT_SECRET="your-secret" ``` [Full Documentation →](https://developers.google.com/workspace/guides/auth-overview)