# Workspace Operator

> Workspace Operator is an open-source MCP server for productivity. Google Workspace automation with staged writes, bulk plans and undo. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI, API
- **Website:** https://pypi.org/project/workspace-operator-mcp/
- **Repository:** https://github.com/artoxem/workspace-operator
- **MCP Registry name:** io.github.Artoxem/workspace-operator
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add workspace-operator -- uvx workspace-operator-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/workspace-operator
