Skip to content
MCP server

Workspace Operator

Google Workspace automation with staged writes, bulk plans and undo

Runs locallyStatus and history
Pricing
Open source
Platforms
self-hosted, CLI, API
Runs
Locally
Version
2.1.2
Listing updated
3 days ago

About Workspace Operator

Workspace Operator is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

Most Workspace connectors answer questions about your mail. This one is built for changing things and being able to roll the change back: bulk operations follow a plan, confirm, run, undo cycle, and Apps Script updates are staged with backups.

It runs on your machine against your own Google OAuth client and exposes 132 tools, 3 resources, 3 resource templates and 8 prompts across Drive, Docs, Sheets, Slides, Gmail, Calendar, Tasks, Forms and Postmaster. Every tool is annotated with readOnlyHint or destructiveHint, and server-side profiles (read-only, read-write, full, plus allow and deny lists) limit what an agent can do.

It is a single-user server: one process, one Google account. The README says it is not suited to multi-tenant or public services. Transports are stdio and Streamable HTTP, locally or in Docker, and the licence is MIT.

Install

Run in a terminal

claude mcp add workspace-operator -- uvx workspace-operator-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "workspace-operator": {
      "command": "uvx",
      "args": [
        "workspace-operator-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "workspace-operator": {
      "command": "uvx",
      "args": [
        "workspace-operator-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "workspace-operator": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "workspace-operator-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "workspace-operator": {
      "command": "uvx",
      "args": [
        "workspace-operator-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "workspace-operator": {
      "command": "uvx",
      "args": [
        "workspace-operator-mcp"
      ]
    }
  }
}

What it does

Plan, confirm, run, undo
Bulk jobs across Drive, Gmail, Docs, Slides and Sheets can be reviewed and reversed.
Apps Script control
Create, stage, execute, cancel and restore scripts, with backups and rollback.
Local file transfer
Upload, download and export files to PDF, DOCX, XLSX and PPTX.
Gmail threads
Work with threads, attachments, in-thread replies, drafts and labels.
Tool profiles
Restrict a session to read-only, read-write or full with allow and deny lists.
Cross-product search
One query over Drive, Gmail and Calendar, merged by date.

Good for

  • Trash a set of old emails and undo if something was wrong
  • Assemble a slide deck from a sheet's table
  • Format a spreadsheet and add conditional rules
  • Stage and test an Apps Script change with a rollback path
  • Draft threaded replies with attachments

Pricing

Open source

MIT licence; runs locally with your own Google OAuth client

Prices change. Check pypi.org before you buy.

Workspace Operator FAQ

Does my data go through a third party?

The README says it runs on your machine and talks to Google through your own OAuth client.

Can several people share one instance?

A small team can share one Google account without isolation; separate accounts need separate instances. It is not for multi-tenant use.

What licence is it under?

MIT.

How many tools does it have?

132 tools plus 3 resources, 3 resource templates and 8 prompts.

Is Workspace Operator free?

Yes. Workspace Operator is open source, so you can use and self-host it for free.

How do I add Workspace Operator to Claude Code?

Run this command in your terminal: claude mcp add workspace-operator -- uvx workspace-operator-mcp

What are the best alternatives to Workspace Operator?

The closest alternatives to Workspace Operator are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

Alternatives to Workspace Operator

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media