Skip to content
MCP server

Google Workspace MCP

Gmail, Calendar, Drive, Docs and Sheets tools for coding agents, run locally

Runs locallyStatus and history
Pricing
Open source
Platforms
vscode, CLI
Runs
Locally
Version
26.11.13
Listing updated
2 days ago

About Google Workspace MCP

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

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

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

{
  "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>"
      }
    }
  }
}

Configuration

  • GOOGLE_APPLICATION_CREDENTIALSPath to a service account key or authorized_user JSON file. Optional if you use gcloud Application Default Credentials or the OAuth variables.
  • GOOGLE_OAUTH_CLIENT_IDOAuth client ID. Set together with the client secret and refresh token.
  • GOOGLE_OAUTH_CLIENT_SECRETOAuth client secret.
  • GOOGLE_OAUTH_REFRESH_TOKENOAuth refresh token with the Gmail, Calendar, Drive, Docs and Sheets scopes.

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Free and MIT licensed.

Prices change. Check renzojohnson.com before you buy.

Google Workspace MCP 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 to Google Workspace MCP

  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. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  5. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  6. CalderFlow

    MCP server

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

    • 10 tools
    • Remote
    • Free
    • Design and media