# Workspace Operator

Workspace Operator — an MCP server for managing Google services via AI agents. Performs bulk operations in Drive, Sheets, Docs, and Gmail with built-in undo support.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12 repo stars
- Author: Artoxem
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Artoxem/workspace-operator
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/workspace-operator

## What it does

Workspace Operator provides an AI agent with 39 tools to interact with Google Workspace. It handles file operations, table formatting, email threads, and calendars, supporting staged changes and rollback. The server runs locally or via Docker using your own Google OAuth client credentials.

It requires Python 3.10 or newer and a configured project in the Google Cloud Console with the necessary APIs enabled. Every tool includes read-only or destructive hints, allowing the agent to distinguish between safe actions and those that modify or delete data.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add workspace-operator -- uvx workspace-operator-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from workspace-operator-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add workspace-operator -- uvx workspace-operator-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from workspace-operator-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "workspace-operator": {
            "command": "uvx",
            "args": [
                "workspace-operator-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from workspace-operator-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "workspace-operator": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "workspace-operator-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from workspace-operator-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add workspace-operator uvx workspace-operator-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from workspace-operator-mcp <command>

## When to use it
- automate Google Drive file management
- perform bulk formatting in Google Sheets
- process Gmail threads and attachments
- sync tasks and calendar events

## Example prompts
- Read the latest email in my inbox and reply with the `report.pdf` attachment
- Search for files created this week in Drive and move them to the `Archive` folder
- Apply the `format_style` to the specified range in `Q3_Results.xlsx`

## Similar
- [google-workspace-cli](https://affpapa.org/en/nevibecode/skills/google-workspace-cli.md) — skill · 636 installs
- [google-workspace](https://affpapa.org/en/nevibecode/skills/mitsuhiko-google-workspace.md) — skill · 108 installs
- [persona-researcher](https://affpapa.org/en/nevibecode/skills/persona-researcher.md) — skill · 32400 installs
- [Google Workspace MCP Server](https://affpapa.org/en/nevibecode/mcp/google-workspace-mcp-server.md) — MCP server · ★ 13 repo stars
- [persona-content-creator](https://affpapa.org/en/nevibecode/skills/persona-content-creator.md) — skill · 31900 installs
- [gog](https://affpapa.org/en/nevibecode/skills/gog.md) — skill · 8500 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
