Google Workspace MCP

Google Workspace MCP is a VS Code extension that gives your AI coding agent direct access to Gmail, Google Calendar, Google Drive, Google Docs, and Google Sheets. You ask a question in plain language, and the agent reads your inbox, checks your schedule, finds a file, or updates a spreadsheet without you leaving the editor.

It works with eight agents: VS Code Copilot, Claude Code, Cursor, OpenAI Codex, Google Gemini, Windsurf, Continue.dev, and Cline. Install it, sign in once, and the extension registers itself with every agent it finds on your machine. There are no config files to hand-edit.

What you can ask

Once the extension is running, these all work as ordinary questions to your agent:

  • “Show me my unread emails”
  • “What meetings do I have today?”
  • “Find the budget spreadsheet in my Drive”
  • “Read the project proposal doc”
  • “Append a row to my tracking sheet”
  • “Send an email to the team about Thursday”

The 16 tools

The extension exposes 16 tools across the five Workspace services. Read tools are listed below; each service also has an admin tool that groups the write actions.

Gmail

Tool What it does
gmail_list List recent emails with metadata
gmail_read Read full email content by ID
gmail_search Search using Gmail query syntax
gmail_send Send an email

The Gmail admin tool covers drafts, labels, trash and untrash, and read status.

Calendar

Tool What it does
calendar_list_events List upcoming events
calendar_get_event Get full event details

The Calendar admin tool creates, updates, and deletes events, and manages calendars.

Drive

Tool What it does
drive_list List files in Drive or a folder
drive_search Search files by name or content

The Drive admin tool handles folders, move, copy, rename, delete, and sharing permissions.

Docs and Sheets

Tool What it does
docs_read Read the full text of a Google Doc
sheets_read Read cell data or sheet metadata

Their admin tools create documents and spreadsheets, append and insert text, find and replace, append rows, update cells, and add or remove sheet tabs.

Destructive actions need explicit confirmation

Deleting a file, trashing an email, and clearing a cell range all require confirm: true before they run. The agent is told this up front, so it has to ask you before it can do something you cannot undo.

Three ways to authenticate

A setup wizard appears the first time you launch the extension and walks you through whichever method fits.

Method Best for What you need
OAuth 2.0 (recommended) Personal Gmail and Workspace accounts A Google Cloud project with OAuth credentials
Application Default Credentials Developers already using the gcloud CLI One terminal command
Service account key Workspace admins using domain-wide delegation A JSON key file plus domain admin setup

For OAuth you enable the Gmail, Calendar, Drive, Docs, and Sheets APIs in your Google Cloud project, create a Desktop app OAuth client, then paste the client ID and secret into the wizard. A browser window opens for you to sign in and authorize.

Which agents it registers with

Agent How it registers
VS Code Copilot VS Code API, automatic
Claude Code ~/.claude.json
Cursor ~/.cursor/mcp.json
OpenAI Codex ~/.codex/config.toml
Google Gemini ~/.gemini/settings.json
Windsurf ~/.codeium/windsurf/mcp_config.json
Continue.dev ~/.continue/config.yaml
Cline VS Code global storage

Each one can be switched off individually under Settings, by searching for gwsMcp.agents.

Install it

Google Workspace MCP is free and MIT licensed.

It is built on the Model Context Protocol, the open standard for connecting AI models to external tools.

Found a bug or want a tool that is missing? Get in touch.

Related