Happy slice of mcp pizzaMCP.pizza

google-workspace-mcp

MCP.Pizza Chef: aaronsb

Eleven tools cover seven Google services across as many accounts as you care to add, so a single request can search your mail, check a calendar, pull a file from Drive and write the result into a Doc. You sign in through Google's own consent screen and the token stays on your computer. Note that the safety limits ship switched off: as installed, it can send mail and permanently delete Drive files, calendar events and tasks without asking you first.

Calendar
Email
Files/PDF
Spreadsheets

Use This MCP server To

Search my inbox and tell me what needs a reply Show me what is on my calendar this week Find a file in Drive and read it back to me Write meeting notes straight into a new Google Doc Read and update a range of cells in a spreadsheet Pull the transcript from a Meet call I missed Switch between my work and personal accounts mid-conversation

README

Google Workspace MCP Server

npm version Latest release Node License

Give your AI agent real access to Google Workspace — Gmail, Calendar, Drive, Docs, Sheets, Tasks and Meet — from one MCP server, across as many accounts as you have.

Search your mail, check your calendar, write a doc, file a task — in conversation, as yourself.

Install

First, you need Google OAuth credentials — the one prerequisite common to every path:

  1. Go to console.cloud.google.com/apis/credentials
  2. Create an OAuth 2.0 Client ID, application type Desktop app
  3. Enable the APIs you want (Gmail, Calendar, Drive, Sheets, Docs, Tasks, Meet)
  4. Keep the Client ID and Client Secret handy — you'll paste them in below

Then pick the path that matches how you work. All three run the same server.

Node 22.12 or newer. (Node 18 and 20 are both end-of-life.)

📦 → 🤖 Claude Desktop — one-click .mcpb install (recommended)

Download google-workspace-mcp.mcpb from the latest release, then drag it onto the Claude Desktop window, or double-click it.

Claude Desktop opens an install dialog with three fields:

Field
Google OAuth Client ID required — from the step above
Google OAuth Client Secret required — from the step above
Workspace Directory optional — where attachments, downloads and exports land. Defaults to ~/.local/share/google-workspace-mcp/workspace/. Give it a dedicated folder — not your home, Documents, Desktop, or a Google Drive folder.

Paste, hit Save, done. No JSON to edit, no Node to install, no paths to get right — the bundle carries the server and every dependency.

One bundle covers every platform — macOS (Intel and Apple Silicon), Linux (x64 and ARM64), and Windows. There is nothing to choose: the server is pure JavaScript, so there is no platform-specific payload to pick between.

Cross-platform note: .mcpb files install via Claude Desktop's bundled handler. If double-clicking doesn't trigger Claude on your system, drag the file onto the Claude Desktop window instead, or right-click → "Open with…" and pick Claude Desktop (then "always open with" if your OS offers). Behavior varies: macOS usually auto-associates, Windows may need a one-time association, Linux varies by desktop environment.

google-workspace-mcp FAQ

Can I use this to send email on my behalf?
Yes, and that is allowed by default. A draft-only mode exists that blocks sending, but you have to switch it on yourself.
Can it delete my files?
Yes. Permanent deletion in Drive, Calendar and Tasks goes through unless you switch on the no-delete or read-only mode.
How do I turn the safety limits on?
Set GWS_SAFETY_POLICY when the server starts, to one or more of read-only, no-delete, draft-only-email or audit. It is empty until you set it.
Is the one-click install really one click?
Nearly. Dragging the bundle onto Claude Desktop avoids editing any files, but you must first create your own Google sign-in credentials in Google's cloud console.
Do I have to pay for anything?
No. It runs on your existing Google account and free Google credentials, with no hosted service and no subscription in between.
Where do my credentials end up?
On your own machine. The server signs in to Google as you, so there is no middleman account to trust.
Which apps does it work in?
Claude Desktop and Claude Code have one-step installs, and any other app that takes a small pasted config block can run it too.
Is it actively maintained?
Yes. The code was last changed at the end of July 2026 and releases have been steady.