google-workspace-mcp

Overview

The Google Workspace MCP Server is a comprehensive implementation that bridges AI agents with Google's productivity suite. It uses a manifest-driven factory approach to transform YAML configurations into functional MCP tools, enabling access to 15+ Google services with approximately 80 operations. The server stands out for its robust architecture, leveraging Google's official Workspace CLI as the underlying engine while adding domain-specific formatting and response handling optimized for AI consumption. Multi-account support with credential isolation makes it suitable for both personal and enterprise use cases.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• manage_email

  Gmail — search, read, send, reply, forward, triage, trash, labels, threads, attachments

  Try:Search my emails for messages about the quarterly reportTry:Send an email to my team with the updated timeline
• manage_calendar

  Calendar — list, agenda, get, create, quickAdd, update, delete, calendars, freebusy

  Try:Show me my agenda for tomorrowTry:Create a new meeting for Friday at 2 PM with the product team
• manage_drive

  Drive — search, get, upload, download, copy, rename, delete, export, permissions, comments

  Try:Find all budget-related files in my DriveTry:Download the Q3 financial report as a PDF
• manage_sheets

  Sheets — read/write ranges, append, clear, manage tabs, copy/duplicate/rename

  Try:Update the sales data in the B2 column of my budget spreadsheetTry:Create a new tab called 'Projections' in my quarterly report
• manage_docs

  Docs — get, create, append, insert text, find-and-replace

  Try:Create a new document called 'Meeting Notes'Try:Find and replace all instances of 'ACME' with 'Company XYZ' in my proposal
• manage_tasks

  Tasks — list/create/update/complete tasks and task lists

  Try:Show me all my incomplete tasksTry:Create a new task to review the Q3 financials by EOD
• manage_meet

  Meet — browse past conferences, participants, transcripts, recordings, smart notes

  Try:Find recordings from last week's product meetingTry:Get the participants from yesterday's all-hands
• manage_accounts

  Multi-account lifecycle — add accounts, manage credentials and scopes

  Try:Add my work account to the serverTry:Switch to my personal Google account
• manage_scratchpad

  Compose/edit multi-line content, attach files, send to any target

  Try:Create a draft email with bullet points for my project updateTry:Write a JSON response with customer feedback
• manage_workspace

  File operations in the workspace sandbox

  Try:Download the attachment from my last emailTry:Export my document as a PDF
• queue_operations

  Chain operations sequentially with result references

  Try:Search for emails from my boss and then read the latest oneTry:Find my meeting transcripts and create a summary document

Comparable tools

Installation

npm install @aaronsb/google-workspace-mcp

{
  "mcpServers": {
    "google-workspace": {
      "command": "npx",
      "args": ["@aaronsb/google-workspace-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

FAQ

What Google Workspace services are supported?

The server currently supports 7 major services: Gmail, Calendar, Drive, Sheets, Docs, Tasks, and Meet, with approximately 80 operations across these services. Full API coverage is documented in docs/coverage.md.

How are Google credentials stored and managed?

Credentials follow XDG Base Directory specifications, stored per-account in ~/.local/share/google-workspace-mcp/credentials/ with standard OAuth tokens. No secrets are stored in the project directory.

Can it handle multiple Google accounts simultaneously?

Yes, it supports multi-account operations with per-account credential isolation, allowing the agent to work across personal and work accounts simultaneously.

Compare google-workspace-mcp with