google_workspace_mcp

google_workspace_mcp 概覽

這是什麼

google_workspace_mcp 是一個全面的 MCP（模型上下文協定）伺服器，讓 AI 助手能透過自然語言控制十二個主要的 Google Workspace 服務，包括 Gmail、Google Calendar、Docs、Sheets、Slides、Chat、Forms、Tasks、Contacts、Drive、Custom Search 和 Apps Script。它包含功能完整的 CLI 和 Code Mode，可使用於 Claude Code 和 Codex 等工具。該伺服器支援多用戶 OAuth 2.1 認證、無狀態部署，以及外部認證伺服器和閘道穿透認證，適合為整個組織集中託管。它可透過 stdio 在本機執行以支援舊版客戶端，也可透過 streamable HTTP 遠端執行。該專案完全開源，採用 MIT 授權，沒有遙測、使用報告或 SaaS 依賴，除非使用者設定可選的 OpenTelemetry 支援。儲存庫中的每一行程式碼都可審計，憑證不會離開使用者環境。伺服器還包含敏感路徑封鎖功能，即使放寬允許的檔案目錄，仍會阻止讀取常見的憑證儲存區。

主要功能

• 在單一 MCP 伺服器中提供超過 120 個工具，涵蓋十二個 Google Workspace 服務 * 支援三個漸進式工具層級（核心、擴展、完整）、唯讀模式、每個服務的權限設定，以及挑選特定工具 * 包含 CLI（workspace-cli），可用於與執行中的伺服器互動，列出和呼叫工具，並具備加密的磁碟備份 OAuth 權杖快取 * 支援 OAuth 2.1（PKCE）以及多用戶認證，並提供原生憑證儲存後端，例如 GCS/CMEK * 支援無狀態容器部署，在鎖定的環境中零磁碟寫入 * 可部署在反向代理之後，支援來源驗證和可信閘道身份

使用情境

將 AI 助手（如 Claude Desktop、Claude Code、ChatGPT、VS Code、LM Studio、Open WebUI 及其他 MCP 客戶端）連接到 Google Workspace，以執行搜尋和發送 Gmail、管理 Calendar 事件、建立和編輯 Docs 與 Sheets、建立 Forms、管理 Tasks 和 Contacts、控制 Chat 訊息和空間，以及執行 Apps Scripts 等任務。CLI 可對這些操作進行腳本化和自動化。該伺服器可在具有安全多用戶認證的組織集中託管。

快速開始

bash # 1. 設定憑證 export GOOGLE_OAUTH_CLIENT_ID='...' export GOOGLE_OAUTH_CLIENT_SECRET='...' # 2. 啟動 - 選擇層級 uvx workspace-mcp --tool-tier core # 基本工具 uvx workspace-mcp --tool-tier extended # 核心 + 管理操作 uvx workspace-mcp --tool-tier complete # 所有工具 # 或挑選服務 uvx workspace-mcp --tools gmail drive calendar

授權與價格

該專案採用 MIT 授權。定價類型為開源。README 中說明，可付費使用受管雲端實例，起價為每月 5 美元。

內容整理自該專案公開的 README 與儲存庫資訊。