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

概覽

AI 產生的概覽

本機 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 可調整行為。
安裝前請注意
專案自述由 AI 編碼代理建置並維護,建議先審查程式碼和工具權限。許多工具會寫入、寄送、共用或刪除資料,包括 Gmail 寄送以及雲端硬碟共用和刪除;可設定 GOG_READONLY 阻擋變更請求。它會操作真實的 Google 帳號,且 GOG_GMAIL_TRUSTED_DOMAINS 會改變哪些外部收件者不觸發稽核提醒。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Gogcli Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

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+
bash
brew install gogcligog auth add [email protected]

Installation

bash
npm install -g gogcli-mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

json
{  "mcpServers": {    "gogcli": {      "command": "gogcli-mcp",      "env": {        "GOG_ACCOUNT": "[email protected]"      }    }  }}

Claude Code

bash
claude mcp add gogcli-mcp -- gogcli-mcp

Tools (116)

ServiceToolsIncludes
Sheets8get, update, append, clear, metadata, create, find-replace, run
Docs7info, cat, create, write, find-replace, structure, run
Gmail6search, get, send, reply, reply-all, run
Calendar7events, get, create, update, delete, respond, run
Drive11ls, search, get, mkdir, rename, move, delete, share, extract-text, read-bytes, run
Slides7export, info, create, copy, list-slides, read-slide, run
Classroom25courses, students, teachers, roster, coursework, submissions (grade/return/turn-in/reclaim), announcements, topics, invitations, profile, run
Chat13spaces list/find/create, threads list, messages list/search/send, dm send/space, reactions list/create/delete, run
Apps Script8get, content, pull, create, deployments, versions, run-function, run
Tasks7lists, list, get, add, done, delete, run
Contacts5search, list, get, create, run
API3list, describe, call
Auth8list, status, health, services, add, add-url, add-complete, run
Upload1slots — signed upload URLs so a hosted caller can hand over a file (see Hosted file uploads)

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:

  1. Call gog_upload_slots with files: [{ filename: "photo.jpg" }] (up to 10). It returns one signed upload slot per file, each with a ready curl command.
  2. PUT each file to its uploadUrl (the Content-Type must be the slot's mimeType; the URL expires after 30 minutes).
  3. Pass the slots' blobKeys to 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
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

23
  1. v4.12.0最新Nov 11, 2026
  2. v4.10.0Nov 7, 2026
  3. v4.9.1Nov 5, 2026
  4. v4.8.1Oct 16, 2026
  5. v4.8.0Oct 12, 2026
  6. v4.7.1Oct 10, 2026
  7. v4.7.0Oct 7, 2026
  8. v4.6.3Oct 5, 2026
  9. v4.6.2Oct 5, 2026
  10. v4.6.1Oct 3, 2026
  11. v4.6.0Oct 2, 2026
  12. v4.5.2Sep 28, 2026
  13. v4.5.1Sep 25, 2026
  14. v4.5.0Sep 24, 2026
  15. v4.3.0Sep 23, 2026
  16. v4.2.5Sep 22, 2026
  17. v4.2.4Sep 21, 2026
  18. v4.2.3Sep 21, 2026
  19. v4.2.0Sep 20, 2026
  20. v4.1.0Sep 20, 2026
  21. v4.0.1Sep 18, 2026
  22. v3.0.0Sep 17, 2026
  23. v2.30.0Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分