Google Workspace MCP
MCP server for Google mail, calendar and files: an agent works across several accounts as you
- 195 ★ on the repository
- Last commit
Broad access
Why this level
- The server sends mail, deletes files and changes sharing in your Google accounts
- Tokens for several accounts with mail and document access sit on disk
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/google-workspace-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The server sends mail, deletes files and changes sharing in your Google accounts
- Tokens for several accounts with mail and document access sit on disk
This is third-party code. Review the repository files before installing.
What it does
The server gives an agent 12 tools across eight Google services: Gmail, Calendar, Drive, Docs, Sheets, Tasks, Meet and Contacts. The agent searches and reads mail, replies and forwards, creates events, downloads and uploads Drive files, edits sheets and documents, manages tasks and browses meeting records. It exposes 95 operations out of the 257 methods Google publishes: the set is trimmed on purpose so the agent chooses more easily. In one request the agent chains several steps: find an invoice in mail, save the attachment to Drive and set a task for Friday. The `bulk_operations` tool runs a chain in a single call or applies one operation to hundreds of messages at once. Every response hints at the next step. Each account token stays on your disk and requests go to Google directly, with no middleman.
Who it is for. People who run mail, calendar and documents across several Google accounts and want to hand the routine to an agent in Claude Code or Claude Desktop.
Good fit when
- Inbox has grown and the agent sorts mail with labels and trashes the rest in a batch
- Work and personal accounts are connected side by side and the agent picks the right one per request
- An invoice email needs its attachment saved to Drive and a reminder set in Tasks
- A spreadsheet is updated row by row and the agent reads a range and appends the result
- Before a meeting the agent checks the calendar, free time and who is in the Meet call
Not a fit when
- You need a full mailbox export or domain administration: the server covers only part of the API
- The account is corporate and policy forbids your own OAuth apps
- Reading a calendar is enough: a ready calendar connector is simpler
Example request
Find the latest invoice email from Acme, save the attachment to the Invoices folder on Drive and add a task to pay on FridayMCP
- Transport
- stdio
- Authentication
- OAuth
Environment variables
GOOGLE_CLIENT_IDrequired- Google OAuth client ID.
GOOGLE_CLIENT_SECRETrequired, secret- Google OAuth client secret.
Limitations
You need your own OAuth credentials: create a "Desktop app" client in the Google console, enable the APIs you want and give the server the client ID and secret. Node.js 22.12 or newer is required. The server sends mail, deletes files and changes sharing as you, so accounts have a read-only mode worth enabling while you watch the agent. Extended Google methods outside the 95 operations are unavailable and can be requested through the repository form.
How to disable. Remove the server in the client (`claude mcp remove google-workspace`) and revoke the app access in your Google account settings. Local tokens live in the server data folder.
FAQ
How do I connect Google Workspace MCP to Claude Code?
Create an OAuth client in the Google console and run `claude mcp add google-workspace -e GOOGLE_CLIENT_ID=... -e GOOGLE_CLIENT_SECRET=... -- npx -y @aaronsb/google-workspace-mcp`. Then `/mcp` shows the server and the first request opens the account sign-in.
Can I connect several accounts?
Yes, the `manage_accounts` tool adds accounts and their scopes, and the server routes each request to the right one. Personal and work accounts run side by side.
Where do my tokens go?
Each account token is stored on your disk and requests go straight to Google. The project runs no service of its own in between.
How do I install it in Claude Desktop without editing files?
Download `google-workspace-mcp.mcpb` from the latest release and drag it onto the Claude Desktop window. Enter the Google client ID and secret in the dialog.
How many operations does the agent get?
95 operations out of the 257 methods Google publishes. `docs/api-surface.md` lists every method and marks which are exposed, and a missing one can be requested through a prefilled issue.
Discussion
No questions or reviews yet.
Related
MCP serversOne MCP server for Gmail, Calendar, Drive, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat and Apps Script with OAuth 2.1
Google Docs MCP: Docs, Sheets, Drive, Gmail and Calendar
Google Docs MCP
An MCP server giving an agent Google Docs, Sheets, Drive, Gmail, Calendar and Apps Script: reading, editing, mail and events; sign-in over OAuth
GSuite MCP
mcp-gsuite
A Python MCP server for Gmail and Google Calendar: search and read emails, drafts and replies, events with attendees, several accounts at once
A CLI for every Google Workspace API with JSON output and agent skills: Drive, Gmail, Calendar, Sheets and more
A Gemini CLI extension for working with Google Docs, Sheets, Slides, Gmail, Chat, Calendar and Drive from the terminal
A local MCP server for Mac and Windows that lets an agent work with mail, messengers, calendars and files.
README in short
The repository describes installation through `.mcpb`, a Claude Code command and a JSON config, then lists 12 tools by Google service. Separate sections cover action chains, batch operations and requests for missing methods.