taylorwilsdon / google_workspace_mcp

Google Workspace MCP Server *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. --- **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** Full setup → **Launch Commands** More options → **Tool Tiers** • - Essential tools • - Core + extras • - Everything Details → Required Configuration Environment Variables ← Click to configure in Claude Desktop **Required** | Variable | Purpose | |----------|---------| | | OAuth client ID from Google Cloud | | | OAuth client secret | | | Development only (allows redirect) | **Optional** | Variable | Purpose | |----------|---------| | | Default email for single-user auth | | | API key for Custom Search | | | Search Engine ID for Custom Search | | | Set to for OAuth 2.1 support | | | Set to for external OAuth flow with bearer tokens (requires OAuth 2.1) | | | Set to 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) • **Download:** Grab the latest from the “Releases” page • **Install:** Double-click the file – Claude Desktop opens and prompts you to **Install** • **Configure:** In Claude Desktop → **Settings → Extensions → Google Workspace MCP**, paste your Google OAuth credentials • **Use it:** Start a new Claude chat and call any Google Workspace tool > **Why DXT?** > Desktop Extensions ( ) 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** (for instant installation) or uv (for development) • **Google Cloud Project** with OAuth 2.0 credentials Configuration Google Cloud Setup ← OAuth 2.0 credentials & API enablement **1. Create Project** Open Console → **2. OAuth Credentials** Download & save credentials **3. Enable APIs** See quick links below OAuth Credential Setup Guide ← Step-by-step instructions **Complete Setup Process:** • **Create OAuth 2.0 Credentials** - Visit Google Cloud Console • 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 • **Enable Required APIs** - In **APIs & Services → Library** • Search for and enable each required API • Or use the quick links below for one-click enabling • **Configure Environment** - Set your credentials: Full Documentation → Quick API Enable Links ← One-click enable each Google API You can enable each one by clicking the links below (make sure you're logged into the Google Cloud Console and have the correc…