MCP.directory
Google Workspace MCP

Google Workspace MCP

taylorwilsdon

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.

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.

1,731171 views505Local (stdio)
productivitycommunication
GitHub

What it does

  • 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

Best for

Business users automating Google Workspace workflowsTeams managing calendars and documents through AIOrganizations centralizing Google services access
Remote OAuth2.1 multi-user supportWorks with all Google account types1-click Claude installation

About Google Workspace MCP

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

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.

Google Workspace MCP Server README image

License: MIT Python 3.10+ PyPI PyPI Downloads Website

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

export GOOGLE_OAUTH_CLIENT_ID="..."
export GOOGLE_OAUTH_CLIENT_SECRET="..."

Full setup →

Launch Commands

uvx workspace-mcp --tool-tier core
uv run main.py --tools gmail drive

More options →

Tool Tiers

  • core - Essential tools
  • extended - Core + extras
  • complete - Everything Details →

Required Configuration

Environment Variables ← Click to configure in Claude Desktop

Required

VariablePurpose
GOOGLE_OAUTH_CLIENT_IDOAuth client ID from Google Cloud
GOOGLE_OAUTH_CLIENT_SECRETOAuth client secret
OAUTHLIB_INSECURE_TRANSPORT=1Development only (allows http:// redirect)

Optional

VariablePurpose
USER_GOOGLE_EMAILDefault email for single-user auth
GOOGLE_PSE_API_KEYAPI key for Custom Search
GOOGLE_PSE_ENGINE_IDSearch Engine ID for Custom Search
MCP_ENABLE_OAUTH21Set to true for OAuth 2.1 support
EXTERNAL_OAUTH21_PROVIDERSet to true for external OAuth flow with bearer tokens (requires OAuth 2.1)
WORKSPACE_MCP_STATELESS_MODESet 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 (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

console.cloud.google.com

→ Create new project
→ Note project name

Open Console →

2. OAuth Credentials

APIs & Services → Credentials
→ Create Credentials
→ OAuth Client ID
→ Desktop Application

Download & save credentials

3. Enable APIs

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

    • 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:

    export GOOGLE_OAUTH_CLIENT_ID="your-client-id"
export GOOGLE_OAUTH_CLIENT_SECRET="your-secret"

Full Documentation →

Quick API Enable Links

README truncated. View full README on GitHub.

Alternatives

GitHub

GitHub

github
27.6k

Extend your developer tools with GitHub MCP Server for advanced automation, supporting GitHub Student and student packag

OfficialRemotePopular
4.5k232
Task Master

Task Master

eyaltoledano
25.8k

Boost productivity with Task Master: an AI-powered tool for project management and agile development workflows, integrat

CommunityPopular
4.9k114
Mastra Docs

Mastra Docs

mastra-ai
21.8k

Mastra Docs: AI assistants with direct access to Mastra.ai’s full knowledge base for faster, smarter support and insight

OfficialPopular
3872
Beads

Beads

steveyegge
18.6k

Beads — a drop-in memory upgrade for your coding agent that boosts context, speed, and reliability with zero friction.

OfficialPopular
8084

Related Skills

Browse all skills
gog

Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

43
google-drive

Manage Google Drive files and folders with full CRUD operations via Ruby scripts. Use for file storage operations, folder organization, sharing permissions, searching across Drive, and uploading/downloading files of any type. Works seamlessly with google-sheets and google-docs skills for complete Google Workspace integration.

10
openclaw-setup

Set up a complete OpenClaw personal AI assistant from scratch using Claude Code. Walks through AWS provisioning, OpenClaw installation, Telegram bot creation, API configuration, Google Workspace integration, security hardening, and all power features. Give this to Claude Code and it handles the rest.

8
ai-boss-assistant

Transform any AI into a professional executive assistant with battle-tested personas and workflows. Complete templates for Google Workspace integration (Gmail, Calendar, Drive), milestone delivery system, and security guidelines.

8
google-workspace

Interact with Google Workspace - create documents, spreadsheets, send emails via Gmail, and manage Google Drive files.

4
api-gateway

API gateway for calling third-party APIs with managed auth. Use this skill when users want to interact with external services like Slack, HubSpot, Salesforce, Google Workspace, Stripe, Shopify, and more.

3