Open Source v1.20.1

Your entire Google Workspace,
orchestrated by AI

The most complete MCP server for Google Workspace. Twelve services, over a hundred tools, one unified interface. Full CLI for Claude Code and Codex.

Documentation

Gmail · Drive · Docs · Sheets · Calendar · Slides · Forms · Chat · Tasks · Contacts · Apps Script

Terminal
$ uvx workspace-mcp
Starting Google Workspace MCP Server... Version: 1.20.1 Tools: 12/12 services enabled Auth: OAuth 2.1 Multi-User Ready for connections

Connect to Claude Desktop
in seconds

Add all twelve Google Workspace MCP services to Claude Desktop, Claude on the web, cowork, and scheduled tasks. Use the custom connector flow — no terminal, no JSON editing.

  • Works with Claude Desktop, web, and cowork
  • OAuth sign-in handles everything
  • Also available as .mcpb bundle from releases
Setup guide Self-hosted install →
Claude Desktop

Built for developers

Twelve MCP servers in one. Run as many or as few tools as you want with dynamic scopes, tool tiers, and read-only mode. Production-ready with OAuth 2.1, CLI mode, and stateless container support.

⌨️

Full CLI for Coding Agents

First-class CLI mode for Claude Code, Codex, and scripting. List tools, invoke them directly, and pipe JSON from stdin.

🔒

OAuth 2.1 Multi-User Auth

Production-ready with OAuth 2.1 bearer tokens, pluggable storage backends (Memory, Disk, Valkey/Redis), and stateless container mode.

⚙️

Flexible Tool Control

Three progressive tool tiers, per-service selection, and a read-only mode that requests only readonly scopes and disables write tools.

🚀

Quick Start Guide

Install, configure OAuth, and connect your first MCP client in five minutes.

 📖

Full API Reference

Every tool across all twelve services — parameters, examples, and usage patterns.

 🔐

OAuth 2.1 Setup

Multi-user auth, stateless mode, external providers, and storage backends.

 ☁️

Managed Cloud Hosting

Let the maintainers run your deployment. Automatic upgrades, flat pricing.

Google Services

Twelve integrated services

Access Gmail, Drive, Docs, Sheets, Slides, Forms, Calendar, Chat, Tasks, Contacts, Apps Script, and Search through a unified AI-friendly interface.

📧

Gmail MCP

Search, read, send, and organize Gmail end to end.

  • Search mail with full Gmail query support
  • Retrieve message bodies and metadata
  • Send or draft email replies
  • Manage labels and entire threads
Explore
📁

Google Drive MCP

Navigate, read, and create Drive files programmatically.

  • Search Drive with advanced query syntax
  • Read stored file content, including Office formats
  • List folder contents by folder ID
  • Create new files or import from URLs
Explore
📅

Google Calendar MCP

Read, create, and update events on any Google Calendar.

  • List every accessible calendar
  • Pull events for any time window
  • Create events with reminders and attachments
  • Update or delete existing meetings
Explore
✅

Google Tasks MCP

Organize Google Tasks with full list and task control.

  • List task lists and filtered tasks
  • Create tasks with hierarchy and due dates
  • Update details or move tasks across lists
  • Clear completed items in a single call
Explore
📝

Google Docs MCP

Create, read, and edit Google Docs through MCP.

  • Read the full contents of any document
  • Create and format new documents
  • Insert lists, tables, and images
  • Batch update headers, footers, and styles
Explore
💬

Google Chat MCP

Automate Google Chat spaces with message access and posting.

  • List available spaces and group chats
  • Fetch historical messages for context
  • Send rich replies directly into spaces
  • Search chat history by keyword
Explore
📊

Google Sheets MCP

Read, write, and manage Google Sheets data.

  • Read any range of cells
  • Write updates or clear ranges in place
  • Create new spreadsheets or tabs
  • Inspect spreadsheet metadata and comments
Explore
🖼️

Google Slides MCP

Generate and tweak presentations without opening Slides.

  • Create entire decks programmatically
  • Retrieve presentation details and slides
  • Batch update text, layouts, and styling
  • Grab slide thumbnails for previews
Explore
📋

Google Forms MCP

Design forms and monitor responses programmatically.

  • Create new forms from scratch
  • Inspect form definitions and questions
  • Adjust publish and sharing settings
  • List or fetch submitted responses
Explore
👤

Google Contacts MCP

Manage contacts and groups via the People API.

  • Search, list, and create contacts
  • Batch create, update, and delete
  • Manage contact groups and labels
  • Add or remove group members
Explore
⚡

Google Apps Script

Automate cross-application workflows with custom code.

  • Create and manage script projects
  • Execute functions with parameters
  • Manage deployments and versions
  • View recent executions and status
Explore
🔍

Google Custom Search

Query custom search engines directly from MCP.

  • Run web searches across programmable CSEs
  • Perform domain-restricted lookups
  • Retrieve custom engine configuration info
  • Return result titles, links, and snippets
Explore

Supported Services:

Gmail MCPGoogle Drive MCPGoogle Calendar MCPGoogle Tasks MCPGoogle Docs MCPGoogle Chat MCPGoogle Sheets MCPGoogle Slides MCPGoogle Forms MCPGoogle Contacts MCPGoogle Apps ScriptGoogle Custom Search

Security & Trust

Your data, your infrastructure

Every request goes directly to Google's APIs. Nothing else is contacted, ever.

For security teams

The entire data path is your infrastructure to Google's APIs on behalf of the authenticated user. There is no telemetry, no analytics, no license server, and no SaaS dependency.

  • Fully open source — every line auditable
  • Your OAuth client, your GCP project — credentials never leave your environment
  • You control the scopes — read-only, per-service, or full access
  • Sensitive paths (.env, .ssh/, .aws/) blocked regardless of config
  • Stateless mode for locked-down containers with zero disk writes

For legal & procurement

MIT licensed — not "open core," not "source available," not gated behind a CLA. The license is 21 lines and says what it means.

  • Use commercially without restriction — build products, sell services, deploy internally
  • No contributor license agreement — contributions remain under MIT
  • No telemetry to disclose — nothing to flag in a privacy review
  • No network effects — the server never contacts any endpoint you didn't configure
  • Standard dependency licenses throughout — MIT, Apache 2.0, and BSD; no copyleft

Reviews

What users are saying

★★★★★
"Perfect! Where can I leave you a review mate? You have been nothing but a 5 star support! I run a marketing business and I know how valuable they can be."
Michael General Manager

Yes, this is a real review from a real paying customer.

See it in action

Watch it work

Manage your Google Workspace through AI with natural language.

Google Workspace MCP Demo

Get started

Ready in minutes

Three steps to connect your AI assistant to Google Workspace.

1

Configure OAuth

Set OAuth credentials via environment variables or place client_secret.json in your project root.

$ export GOOGLE_OAUTH_CLIENT_ID="your-id"
$ export GOOGLE_OAUTH_CLIENT_SECRET="your-secret"
2

Start the server

Launch the MCP server with a single command.

$ uvx workspace-mcp --transport streamable-http
Ready on http://localhost:8000
3

Add the connector

Open Connectors in Claude, add a custom connector, and paste your MCP server URL. Works with Claude Desktop, web, and cowork.

See setup instructions →
Follow the full setup guide

Ready to connect AI to Google Workspace?

Twelve services and over a hundred tools, MIT licensed. One command to install, one OAuth flow to connect.

100+ API Tools
12 Services
MIT Licensed
Start building Star on GitHub