Google Workspace MCP Server
io.github.mindstone/mcp-server-google-workspace
Access Gmail, Calendar, Drive, Docs, Sheets, Slides, Contacts, and more via Google Workspace with host-orchestrated OAuth.
What is the Google Workspace MCP server?
The Google Workspace MCP server enables read, search, and send capabilities across Gmail, Calendar, Drive, Docs, Sheets, Slides, Contacts, and Comments. It uses host-orchestrated OAuth with per-account on-disk credentials for secure, multi-account access to Google's productivity suite.
This server integrates your Google Workspace account with AI agents, allowing you to read and search emails, manage calendar events, browse and interact with Drive files, edit documents and spreadsheets, create presentations, manage contacts, and handle comments—all through a unified MCP interface with enterprise-grade OAuth security.
How to install Google Workspace
Copy-paste configuration for popular MCP clients.
GOOGLE_CLIENT_IDrequiredGoogle OAuth client ID
GOOGLE_CLIENT_SECRETrequiredsecretGoogle OAuth client secret
ACCOUNTS_PATHrequiredPath to accounts.json written by the MCP host
CREDENTIALS_PATHrequiredDirectory containing per-account Google OAuth token files
GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MSOutbound Google API request timeout in milliseconds (max 300000 = 5 min)
GOOGLE_WORKSPACE_DISABLE_REFRESHSet to 1 to disable background OAuth token refresh (tokens are only read, never refreshed)
MCP_WORKSPACE_PATHDirectory attachments and downloaded files are constrained to (defaults to a temp dir; reads/writes outside it are refused)
WORKSPACE_BASE_PATHLegacy fallback for MCP_WORKSPACE_PATH; prefer MCP_WORKSPACE_PATH
GAUTH_FILELegacy fallback path to gauth.json OAuth client config; host-orchestrated setups use GOOGLE_CLIENT_ID/GOOGLE_CLIENT_SECRET instead
Tools & capabilities
Tools this server exposes to the agent.
Gmail read and search— Read, search, and send emails through GmailCalendar management— List, create, update, and manage calendar eventsDrive access— Browse, search, and interact with Google Drive filesDocs editing— Read and edit Google Docs documentsSheets management— Read and edit Google Sheets spreadsheetsSlides creation— Create and manage Google Slides presentationsContacts management— Manage and search Google ContactsComments handling— Read and manage comments across Google Workspace apps
Use cases
- Search and retrieve emails from Gmail, then summarize or extract information from them
- Check calendar availability and create or update events automatically
- Browse Google Drive files and folders, then read or download documents for analysis
- Edit Google Docs or Sheets collaboratively through AI-assisted workflows
- Create presentations in Google Slides with AI-generated content
- Manage contact information and sync updates across your organization
Google Workspace MCP server FAQ
It's an MCP server that connects Claude, Cursor, or other MCP hosts to your Google Workspace account, giving AI agents the ability to read, search, and send emails; manage calendars; access Drive files; edit Docs and Sheets; create Slides; manage Contacts; and handle Comments.
The MCP server itself is open-source and free. You need a Google Workspace account (which may be free or paid depending on your organization) and valid API credentials to connect.
Install via npm: `npm install @mindstone/mcp-server-google-workspace`. Then configure your MCP host (Cursor, Claude Desktop, or Rebel) to load the server with your Google OAuth credentials. See the connector's README for detailed setup instructions.
The server uses host-orchestrated OAuth with per-account on-disk credentials, meaning your MCP host manages the OAuth flow securely and stores credentials locally for each Google account you connect.
Yes, the server supports multi-account access through host-orchestrated OAuth, allowing you to manage credentials for multiple Google Workspace accounts simultaneously.
The server follows defence-in-depth security practices including workflow safety, release-age cool-downs, provenance-attested releases, and OpenSSF Scorecard compliance. External content is wrapped in untrusted-content envelopes to prevent instruction injection.
README (reference)
Source of truth, from the repository.
mcp-servers
Source-available MCP servers by Mindstone. Works with any MCP host — Claude Desktop, Cursor, Rebel, and others.
Browse all 35 connectors with their version, auth model, and tool count at the catalogue site (regenerated from each connector's STATUS.json on every push).
Connectors
| Connector | Description |
|---|---|
| apple-shortcuts | Run and list Apple Shortcuts on macOS via the shortcuts CLI |
| browser-automation | Headless browser control via accessibility snapshots — navigate, fill forms, click, and screenshot pages via the agent-browser CLI |
| elevenlabs | Generate speech, music, and sound effects, browse voices, and transcribe audio via the ElevenLabs API |
| email-imap | Read, search, send, and manage emails through IMAP and SMTP |
| fathom | List and search meetings, view details, read transcripts, and manage teams via Fathom AI |
| freshdesk | Manage helpdesk tickets, search support requests, reply to customers, and add internal notes |
| gamma | Create AI-powered presentations, documents, webpages, and social posts via Gamma |
| google-analytics | Discover GA4 accounts and properties, explore the live schema, and run reports via the Google Analytics API |
| google-workspace | Read, search, and send across Gmail, Calendar, Drive, Docs, Sheets, Slides, Contacts, and Comments with host-orchestrated OAuth and per-account on-disk credentials |
| hubspot | Manage HubSpot CRM — contacts, companies, deals, tickets, leads, tasks, notes, properties, lists, workflows, knowledge base, and files — with multi-account, host-orchestrated OAuth |
| humaans | Query employee profiles, job roles, time-away requests, and company info via Humaans HR |
| kling | Generate AI videos from text descriptions or images via Kling AI |
| microsoft-calendar | List, create, update, and respond to Outlook calendar events, check free/busy, and list calendars; reuses the cohort's host-orchestrated Microsoft 365 OAuth surface |
| microsoft-files | List, search, upload, download, share, and read OneDrive files via Microsoft Graph; reuses the cohort's host-orchestrated Microsoft 365 OAuth surface |
| microsoft-mail | List, search, read, send, reply, forward, draft, move, and delete Outlook email; owns the cohort's host-orchestrated Microsoft 365 OAuth surface |
| microsoft-sharepoint | Discover sites, browse libraries, read pages and lists, search content, and mutate SharePoint files/lists with incremental Sites.Read.All consent |
| microsoft-teams | List and read Teams chats, send chat messages, list teams and channels, and read presence; reuses the cohort's host-orchestrated Microsoft 365 OAuth surface |
| mixmax | Manage sequences, send tracked emails, use templates, and monitor engagement via Mixmax |
| nano-banana | Generate and edit images using Google Gemini's AI capabilities |
| napkin | Generate professional visuals — diagrams, infographics, and illustrations — from text via Napkin AI |
| office | Read and edit Word documents, Excel workbooks, and PowerPoint presentations from desktop Microsoft 365 via an Office Add-in sidecar |
| openai-image | Generate and edit images via OpenAI's gpt-image-2 — sharp text rendering, multilingual support, and four quality levels |
| outreach | Manage prospects, sequences, accounts, tasks, and mailings via the Outreach sales engagement API |
| pandadoc | Create, send, and manage documents, templates, and e-signatures via PandaDoc |
| quickbooks | Manage invoices, bills, customers, vendors, employees, and accounts in QuickBooks Online |
| replit-ssh | Read, write, list, and check files on Replit projects over SSH/SFTP, with one-shot SSH key + config setup on the operator's machine |
| retell-ai | Place voice-agent phone calls, manage agents and LLM prompts, and discover voices via the Retell AI API |
| runway | Generate AI video, images, audio, speech, and sound effects via Runway ML |
| salesforce | Manage accounts, contacts, opportunities, leads, tasks, users, and custom objects via the Salesforce API |
| servicenow | Manage incidents, change requests, users, and knowledge base articles in ServiceNow |
| slack | Multi-workspace Slack — channels, messages, threads, reactions, users, files, bookmarks, and scheduled messages via the Slack Web API, with host-orchestrated OAuth |
| talentlms | Manage users, courses, groups, branches, enrolments, and assessments in TalentLMS |
| vanta | Read and manage compliance posture in Vanta — vulnerabilities, tests, controls, evidence, resources, people, vendors, documents, and compliance summary |
| workday | Query workers, profiles, and organizations in Workday HCM |
| zendesk | Manage tickets, macros, users, and views in Zendesk Support |
Quick Start
Each server builds independently:
cd connectors/<name>
npm install
npm run build
Or run directly via npx (once published):
npx -y @mindstone/mcp-server-zendesk
Moving from
@mindstone-engineering/? Every server has been republished under the shorter@mindstone/npm scope. The legacy@mindstone-engineering/mcp-server-*packages still install but are marked deprecated. See MIGRATION.md for the consumer one-liner and the deprecation timeline.
See each server's README for configuration and host setup instructions. Some connectors require additional environment variables to opt into specific behaviour (e.g. QB_ALLOW_PROD_WRITES for QuickBooks production writes, MCP_WORKSPACE_PATH for sandboxed file reads) — see the per-connector READMEs for the full list.
Security & Hardening
This monorepo follows a defence-in-depth posture for tool-call hosts. Highlights include:
- Workflow safety. GitHub Actions workflows are env-fy'd against script injection (CWE-94), every action is pinned to a commit SHA (kept current by Dependabot), and each job is granted a least-privilege
permissions:block. Publish is split into a build job (does the install/test/pack with no publish credentials) and a publish job (downloads the packed tarball, runs onlynpm publish --ignore-scripts --provenanceunder OIDC trusted publishing, gated by thenpm-publishenvironment). The publish job invokes NO third-party JS —tsc,vitest, lifecycle scripts, etc. all run upstream, away fromid-token: write. See docs/security/AUDIT_FOX-3319_tanstack_supply_chain.md for the supply-chain threat model and docs/security/BRANCH_PROTECTION.md for required GitHub settings. - Release-age cool-down. The repo-level
.npmrcsetsmin-release-age=7(days), so CI refuses to install dependency versions published in the last week. This blocks the "same-day malicious re-publish" path that ships post-npm audit-clean PRs into a release tag. - Provenance-attested releases. Releases are published by CI (
.github/workflows/release.yml) under the@mindstone/npm scope via Trusted Publishing OIDC — no long-lived npm token exists anywhere — with--provenanceSigstore attestations consumers can verify vianpm audit signatures. Every publishable release commit must carry aRelease-Gatetrailer pointing at its pre-release security review, and every publish posts an alert; the full gate chain is in docs/PUBLISH_APPROVAL_PROCESS.md. (Only a brand-new connector's first publish is manual and WebAuthn-gated; those tarballs carry no provenance attestation but remain shasum-verifiable — check out the release commit and runnpm pack; see MIGRATION.md.) - OpenSSF Scorecard. The repo runs the OpenSSF Scorecard weekly via
.github/workflows/scorecard.yml. The report is generated by a third party from the source tree, so every claim above (action pinning, branch protection, token usage, dependency hygiene) is independently checked rather than just asserted here. The current score is shown by the badge at the top of this README.
Recommendations for consumers
These connectors are published as plain npm packages. The strongest single thing you can do to protect yourself from a future supply-chain compromise of any npm package (these or otherwise) is to use a client that does not run lifecycle scripts by default:
- pnpm (
pnpm install/pnpm dlx) — does not executepostinstall/preparehooks unless explicitly allowlisted viaonlyBuiltDependencies. pnpm v11+ also defaults to a 24-hourminimumReleaseAgecool-down. - bun (
bunx) — same default, no lifecycle scripts unless allowlisted. - npm — if you must use npm, set
min-release-age=7andignore-scripts=truein your global~/.npmrc. Requires npm v11.10+ formin-release-age.
None of our published packages need postinstall to function, so disabling lifecycle scripts in your installer of choice is safe.
- Untrusted-content envelopes. External content from email, helpdesk, and ticketing systems (email-imap, freshdesk, zendesk) is wrapped in
<untrusted-content source="...">envelopes with close-tag breakout escaping, so an LLM host can recognise and refuse instruction-injection attempts. - Workspace sandboxing. File-uploading connectors (nano-banana, pandadoc, elevenlabs) constrain reads to
MCP_WORKSPACE_PATH(oros.tmpdir()) with canonical-prefix containment that handles symlinked roots like/tmp→/private/tmp. - Secure-by-default writes. Production-impacting writes (QuickBooks invoices/bills/customers/vendors) require an explicit
QB_ALLOW_PROD_WRITES=1opt-in env var; outreach prospect-enrolment and mixmax sequence-recipient tools carrydestructiveHint: trueso hosts surface confirmation prompts. - SSRF & path traversal. Download connectors (napkin, runway) enforce host allow-lists, manual-redirect handling, and symlink-safe write paths under a configurable root.
- Loopback OAuth bind. Connectors with local OAuth callback servers (salesforce, outreach) hard-code 127.0.0.1, ignoring any
MCP_OAUTH_BIND_HOSToverride. - E.164 validation. Outbound phone-call tools (retell-ai) reject non-E.164 numbers before any upstream API call.
For per-connector security notes, see each connector's README.
To report a vulnerability, please see SECURITY.md.
The Mindstone open-source family
This repo is one of several open-source projects from Mindstone:
- Rebel — the AI workspace desktop app that ships these connectors out of the box (source release in progress).
- Super-MCP — a proxy MCP router that loads only the tools you actually need, saving your context window.
- rebel-system — the public Rebel system: skills, prompts, operators, help docs, and templates.
- meeting-note-recorder — meeting detection, recording, and live transcripts (the Rebel note-taker).
Licence
Each connector is licensed under FSL-1.1-MIT — see the LICENSE file in each connector directory for details.
Related MCP servers

HubSpot
Manage HubSpot CRM contacts, deals, tickets, and workflows with multi-account OAuth integration.

Humaans
Query employee profiles, job roles, time-away requests, and company info via Humaans HR platform.

Kling
Generate AI videos from text descriptions or images via Kling AI

Microsoft 365 Calendar
Access Microsoft 365 Outlook calendar events—list, create, update, respond, and check availability.

Microsoft 365 Files
Access, search, upload, and share OneDrive files via Microsoft 365 Graph API.

Microsoft 365 Mail
Read, search, send, reply, forward, draft, move, and delete Outlook email via Microsoft 365 Graph API.