Workspace Operator
Google Workspace automation with staged writes, bulk plans and undo
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"workspace-operator": {
"command": "uvx",
"args": [
"workspace-operator-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"workspace-operator": {
"command": "uvx",
"args": [
"workspace-operator-mcp"
]
}
}
}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

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media