Google Workspace

Google Workspace

Production-ready Google Workspace MCP server with multi-user OAuth 2.1 support and Claude integration.

930
Stars
269
Forks
20
Releases

Overview

An end-to-end MCP server that bridges Google Workspace services with AI assistants. It integrates Gmail, Drive, Calendar, Docs, Sheets, Slides, Forms, Tasks, and Chat, plus search capabilities, delivering comprehensive control and automation across Workspace. Built on FastMCP for high performance, it features advanced authentication handling, service caching (30-minute TTL), and streamlined development patterns. The server supports both single-user operation and multi-user authentication via OAuth 2.1, with a simplified setup that leverages Google Desktop OAuth clients—no redirect URIs or port configuration required. It offers transport options including Streamable HTTP and SSE for MCP, as well as stdio and HTTP modes for Claude Desktop. Key security features include automatic token refresh, session management, and a transport-aware architecture with a robust CORS proxy. It also supports stateless container-friendly operation and an external OAuth 2.1 provider mode for external auth flows. Claude Desktop integration provides a one-click install path, while the internal credential store and tooling system enable selective service loading and secure credential management. Reverse proxy compatibility is documented for external deployments.

Details

Owner
taylorwilsdon
Language
Python
License
MIT License
Updated
2025-12-07

Features

Gmail/Drive/Calendar/Docs integration

Complete Gmail management, end-to-end coverage; full calendar operations with advanced features; file handling with Office formats; document creation, editing, and comments; deep support for granular editing.

Forms/Chat/Sheets/Slides integration

Form creation and publishing; collaboration spaces and messaging; spreadsheet operations; presentation creation and editing.

Authentication & Security

Advanced OAuth 2.0 & OAuth 2.1 support; automatic token refresh and session management; transport-aware callbacks; multi-user bearer token authentication; innovative CORS proxy architecture.

Transport Support

Full support for all MCP transports, including streamable-http; supports stdio and HTTP modes; optimized for secure, scalable deployments.

OAuth 2.1 Multi-User & Stateless Modes

Supports multi-user authentication with OAuth 2.1; stateless mode for containerized deployments; external OAuth provider mode for integrating with external auth systems.

Claude Desktop Integration

One-click Claude Desktop installation (DXT) and configuration for seamless Workspace tooling and workflows.

Credential Store & Security

Abstract credential store with LocalDirectoryCredentialStore backend; configurable storage; multi-user credential management; secure handling with no secrets committed to git.

Audience

DevelopersBuild AI-powered apps and assistants that integrate Google Workspace via MCP.
BusinessesDeploy a multi-user OAuth 2.1 backend for organizational workflows spanning Gmail, Drive, Calendar, and more.
Claude usersIntegrate Claude Desktop with Google Workspace MCP to enable streamlined workflows.

Tags

Google WorkspaceMCPOAuth 2.1Multi-userStreamable HTTPSSEClaude DesktopFastMCPGmailDriveCalendarDocsSheetsSlidesFormsTasksChatCustom SearchAI assistantsReverse proxyCredential storeStateless mode