a-bonus/google-docs-mcp

解決的問題

本專案提供一個 Model Context Protocol (MCP) 伺服器，讓 AI 助手（如 Claude Desktop、Cursor 或 Windsurf）能直接與 Google Workspace 生態系互動。它消除了手動複製貼上的需求，讓 LLM 能夠讀取、建立和修改 Google Docs、Sheets、Drive、Gmail 和 Calendar 中的內容。

運作方式

伺服器扮演 MCP 相容客戶端與 Google API 之間的橋樑。它使用 OAuth 2.0 進行驗證，並公開一系列 AI 可呼叫的「工具」。這些工具對應到特定的 API 操作，例如以 markdown 格式讀取文件、向試算表追加資料列，或搜尋電子郵件。它可透過 npx 本地部署，也可在 Google Cloud Run 上遠端部署，供團隊共用。

適用對象

希望其 LLM 能直接存取個人或專業 Google Workspace 資料，以實現自動化、文件起草與排程的 AI 程式碼編輯器與助手使用者。

主要特色

• 全面的 Workspace 整合：支援 Google Docs、Sheets、Drive、Gmail 和 Calendar 的完整 CRUD 操作。
• Markdown 工作流程：支援以 markdown 格式讀取與取代文件內容，方便 LLM 編輯。
• 細緻的試算表控制：提供高階試算表工具，包括單元格格式設定、條件格式、表格建立與範圍保護。
• Gmail 與日曆自動化：提供收件匣分類、寄送郵件、管理草稿，以及包含 Google Meet 連結的日程安排工具。
• Apps Script 支援：可建立與編輯底層 Apps Script 專案，以實現更深入的自動化。
• 彈性部署：支援本地 stdio 傳輸與透過 Cloud Run 的遠端 httpStream 部署。