
Gogcli Mcp
io.github.chrischall由 GitHub 帳號 chrischall 發布v4.12.0更新於 Nov 11, 2026
Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets
概覽
本機 MCP 伺服器,透過 gogcli 為助理提供 116 個工具,用來讀取與管理 Google Workspace 資料,例如試算表、文件、Gmail、日曆和雲端硬碟。
- 可以做什麼
- 讀取、建立、更新、附加、清空 Google 試算表並執行尋找取代,以及讀取、建立和寫入文件
- 搜尋、讀取、寄送和回覆 Gmail,並列出、建立、更新、刪除和回覆日曆活動
- 列出、搜尋、移動、重新命名、共用、刪除雲端硬碟檔案並擷取文字,匯出或讀取簡報
- 管理 Classroom 課程、名單、作業與提交,以及 Chat 空間、討論串、訊息和表情回應
- 執行 Apps Script 函式與部署,管理工作和聯絡人,並透過通用 Discovery 介面呼叫任意 Google API
- 查看授權狀態與服務,並為託管部署建立簽章上傳槽位以交付檔案
- 適用情境
- 適合希望助理直接操作 Google Workspace 帳號的情境,例如編輯試算表和文件、處理郵件、安排行程或整理雲端硬碟檔案,可在本機的 Claude Desktop 或 Claude Code 中使用。
- 執行需求
- 僅限桌面端,透過 stdio 在本機執行。需要 Node.js 22+,並安裝與授權 gogcli(例如透過 brew 安裝並執行 gog auth add)。GOG_ACCOUNT 指定 Google 帳號;選用變數 GOG_PATH、GOG_READONLY、GOG_TIMEZONE、DISPLAY_TZ 和 GOG_GMAIL_TRUSTED_DOMAINS 可調整行為。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Gogcli Mcp,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
gogcli-mcp
[!WARNING] AI-developed project. This codebase was built and is actively maintained by Claude Code. Review all code and tool permissions before use.
Base Model Context Protocol server that gives Claude access to Google Workspace via gogcli. Includes 116 tools across 13 services: Sheets, Docs, Gmail, Calendar, Drive, Slides, Classroom, Chat, Apps Script, Tasks, Contacts, the generic Discovery API escape hatch, and Auth — plus hosted file uploads.
For extended Sheets or Docs support, see gogcli-mcp-sheets and gogcli-mcp-docs.
Requirements
- gogcli installed and authenticated
- Node.js 22+
Installation
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
Claude Code
Tools (116)
All tools accept an optional account parameter to target a specific Google account.
Hosted file uploads
On a hosted deployment (mcp-host) the server shares no filesystem with you, so a
path like attach, localPath, file or image names a file on the server
and is refused with an explanation. To hand the server a file you hold:
- Call
gog_upload_slotswithfiles: [{ filename: "photo.jpg" }](up to 10). It returns one signed upload slot per file, each with a readycurlcommand. PUTeach file to itsuploadUrl(theContent-Typemust be the slot'smimeType; the URL expires after 30 minutes).- Pass the slots'
blobKeysto the tool that takes the file.
Each file is held to 25 MiB. It is deleted from the upload store once that call
succeeds, and kept if the call fails so a retry can reuse the same keys. On a
gated send (gog_gmail_send, gog_gmail_reply, gog_gmail_reply_all,
gog_chat_messages_send) the confirmation preview reads the file without
deleting it and binds its SHA-256, so a file re-uploaded between the preview and
the approval is refused rather than sent unseen.
blobKeys is accepted by gog_gmail_send, gog_gmail_reply,
gog_gmail_reply_all and gog_chat_messages_send here, and by the Gmail drafts
tools and gog_gmail_import (gogcli-mcp-gmail), gog_drive_upload
(gogcli-mcp-drive), the Slides image tools (gogcli-mcp-slides) and the Docs image
tools (gogcli-mcp-docs). For a small file, attachInline (base64 in the call, up
to 8 MiB) still works on any deployment. On a local install gog_upload_slots
refuses: pass a path instead.
License
MIT
來源:packages/gogcli-mcp/README.md,提交 4302bf8
工具
0版本歷史
23- v4.12.0最新Nov 11, 2026
- v4.10.0Nov 7, 2026
- v4.9.1Nov 5, 2026
- v4.8.1Oct 16, 2026
- v4.8.0Oct 12, 2026
- v4.7.1Oct 10, 2026
- v4.7.0Oct 7, 2026
- v4.6.3Oct 5, 2026
- v4.6.2Oct 5, 2026
- v4.6.1Oct 3, 2026
- v4.6.0Oct 2, 2026
- v4.5.2Sep 28, 2026
- v4.5.1Sep 25, 2026
- v4.5.0Sep 24, 2026
- v4.3.0Sep 23, 2026
- v4.2.5Sep 22, 2026
- v4.2.4Sep 21, 2026
- v4.2.3Sep 21, 2026
- v4.2.0Sep 20, 2026
- v4.1.0Sep 20, 2026
- v4.0.1Sep 18, 2026
- v3.0.0Sep 17, 2026
- v2.30.0Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分