# Google Workspace MCP

> Google Workspace MCP is an open-source MCP server for productivity. Gmail, Calendar, Drive, Docs and Sheets tools for coding agents, run locally. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** vscode, CLI
- **Website:** https://renzojohnson.com/contributions/google-workspace-mcp
- **MCP Registry name:** com.renzojohnson/google-workspace-mcp
- **Categories:** productivity, communication
- **Listing updated:** 2026-11-15

## About

Sixteen tools sit behind this server: ten for reading and searching, five "admin" tools that group the write actions for each service, and a ping tool that checks the server is alive. That layout lets one request chain services, for example finding a file in Drive, reading it with the Docs tool and drafting a Gmail message about it.

It can be installed as a VS Code extension, which registers itself with eight agents (Copilot, Claude Code, Cursor, Codex, Gemini, Windsurf, Continue.dev and Cline), or run from npm with `npx -y @renzo.johnson/google-workspace-mcp` in any MCP client. Outside VS Code there is no setup wizard, so the server picks up Google sign-in from environment variables, a key file or gcloud Application Default Credentials. Node.js 22 or newer is needed.

Destructive actions such as deleting a file, trashing an email, removing document text or clearing a cell range only run when `confirm: true` is passed, so the agent has to ask first. The author says the server runs on your machine, talks only to Google's APIs and has no telemetry. It is an independent project, not Google's official Workspace MCP server, and it is a local server for coding agents rather than a connector for the Claude web app.

## Features

- **One server, five services:** Gmail, Calendar, Drive, Docs and Sheets share a single install.
- **Confirmation on destructive actions:** Deletes, trashing and range clears require an explicit confirm flag.
- **Three sign-in methods:** OAuth 2.0, gcloud Application Default Credentials or a service account key.
- **Automatic agent registration:** The VS Code extension writes config for eight agents and can be toggled per agent.
- **Runs without VS Code:** The npm package works in Claude Code, Cursor or any MCP client.
- **Pick only the APIs you need:** A service whose API you did not enable returns a permission error while the rest keep working.

## Good for

- Summarise unread email and today's meetings from the editor
- Find a spreadsheet in Drive and append a row to it
- Draft a Gmail reply and book a Calendar slot in one request
- Read a project proposal Doc and pull out action items

## Install

### Claude Code (Terminal)

```sh
claude mcp add google-workspace-mcp --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-workspace-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-workspace-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-workspace-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "google-workspace-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-workspace-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-workspace-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-workspace-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}
```

## Tools

- `gmail_list`: List Gmail messages
- `gmail_read`: Read a Gmail message
- `gmail_search`: Search Gmail
- `gmail_send`: Send an email
- `calendar_list_events`: List Google Calendar events
- `calendar_get_event`: Get one calendar event
- `drive_list`: List Drive files
- `drive_search`: Search Drive
- `docs_read`: Read a Google Doc
- `sheets_read`: Read a Google Sheet

## FAQ

### Is it Google's official Workspace MCP server?

No. It is an independent extension that calls Google's public APIs with your own sign-in.

### Does it need a paid Workspace account?

No. OAuth works with a free personal Google account; only the service account method needs a Workspace admin.

### Where does my data go?

The server runs on your machine and calls Google's APIs with your credentials. The author states there is no telemetry and the token is kept in VS Code's encrypted secret storage.

### Which licence does it use?

MIT.

### Is Google Workspace MCP free?

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

### How do I add Google Workspace MCP to Claude Code?

Run this command in your terminal: claude mcp add google-workspace-mcp --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-workspace-mcp

### What are the best alternatives to Google Workspace MCP?

The closest alternatives to Google Workspace MCP are Ha MCP, Concord MCP, note1, BoardAgent and Callout.

## 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.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [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.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

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