Skip to content
Workspace MCP (Google Workspace)

Workspace MCP (Google Workspace)

Released
v2.4.1
MIT

Summary

Open-source MCP server for twelve Google Workspace services — Gmail, Drive, Calendar, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat, Apps Script and Custom Search — with OAuth 2.1 multi-user auth.

Features

  • 120+ tools across Gmail, Drive, Calendar, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat, Apps Script and Search
  • core / extended / complete tool tiers and per-service selection
  • Read-only mode and per-service permissions
  • OAuth 2.1 multi-user auth, stateless container mode and service accounts with domain-wide delegation
  • Bundled workspace-cli for scripting the same tools

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

  1. Open your agent's MCP configuration file.
  2. Merge the snippet below into it, filling in the environment variables with your own values.
  3. Restart the agent — the "Workspace MCP (Google Workspace)" tools will be available.
{
  "mcpServers": {
    "workspace-mcp": {
      "command": "uvx",
      "args": [
        "workspace-mcp",
        "--tool-tier",
        "core"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "<YOUR_OAUTH_CLIENT_ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<YOUR_OAUTH_CLIENT_SECRET>"
      }
    }
  }
}

Description

Workspace MCP, by Taylor Wilsdon, puts 120+ tools for Google Workspace behind a single MCP server that you run with your own Google Cloud OAuth client. It covers Gmail (search, send, drafts, labels, filters, attachments), Drive (search, create, share, import Office files), Calendar (events, free/busy, Out of Office and Focus Time), Docs (editing, styles, tables, tabs, comments, export), Sheets, Slides, Forms and their responses, Tasks, Contacts, Chat, programmable Custom Search, and Apps Script — write, deploy, run and debug scripts.

Context control. Three tool tiers — core, extended and complete — keep the tool list proportionate to the job, and --tools gmail drive calendar cherry-picks services. --read-only and per-service permissions restrict writes, and HTTP clients sharing one server can each request a different toolset through headers.

Designed to be hosted for a team. Beyond single-user stdio, it supports OAuth 2.1 with PKCE for multi-user HTTP deployments, a stateless container mode with zero disk writes, external OAuth providers, service accounts with domain-wide delegation, trusted-gateway identity, and Valkey/Redis or Google Cloud Storage backends for scaled-out deployments. A bundled workspace-cli calls the same tools from a terminal, and there is a companion agent skill.

The security story is straightforward: no telemetry, no licence server, and no data sent anywhere but Google's APIs; local file reads are confined to an attachment directory with credential paths always blocked. Google Chat requires a Workspace account and a one-time Chat app setup. MIT-licensed and independent — not affiliated with Google, whose own hosted Workspace MCP endpoints are a separate product.

Featured

Google's own remote MCP endpoints for Gmail, Drive, Docs, Sheets, Slides, Calendar, Chat and People — OAuth 2.0, hosted by Google, no server to run.

80 views

MCP: Cal.com MCP

by Cal.com

Cal.com's official MCP server: book, reschedule and cancel meetings, manage event types and schedules, and query real availability from a chat client.

Featured

Google's official MCP server for the Home ecosystem — let an agent list your homes and devices, read live trait state, run actions and query event history over OAuth.

Browse all MCP servers →