google-workspace-mcp

概述

Google Workspace MCP Server 是一个全面的实现，将 AI 代理与 Google 生产力套件连接起来。它采用清单驱动的工厂方法，将 YAML 配置转换为功能性的 MCP 工具，实现对 15+ 种 Google 服务的访问，约 80 种操作。该服务器因其强大的架构而脱颖而出，利用 Google 官方的 Workspace CLI 作为底层引擎，同时添加特定领域的格式化和针对 AI 消费优化的响应处理。多账户支持和凭证隔离使其适合个人和企业使用场景。

试试问 AI

装完之后，这里有 6 个你可以让 AI 做的事：

• manage_email

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

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

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

  试试:Show me my agenda for tomorrow试试: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

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

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

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

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

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

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

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

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

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

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

  试试:Add my work account to the server试试:Switch to my personal Google account
• manage_scratchpad

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

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

  File operations in the workspace sandbox

  试试:Download the attachment from my last email试试:Export my document as a PDF
• queue_operations

  Chain operations sequentially with result references

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

可对比工具

安装

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

支持哪些 Google Workspace 服务？

当前支持 7 个主要服务：Gmail、日历、Drive、表格、文档、任务和会议，这些服务共有约 80 种操作。完整的 API 覆盖范围记录在 docs/coverage.md 中。

Google 凭证如何存储和管理？

凭证遵循 XDG 基础目录规范，每个账户存储在 ~/.local/share/google-workspace-mcp/credentials/ 中，使用标准的 OAuth 令牌。项目目录中不存储任何秘密。

能否同时处理多个 Google 账户？

是的，它支持多账户操作，每个账户有凭证隔离，允许代理同时处理个人和工作账户。

google-workspace-mcp 对比