Google Workspace (gsuite-sdk)

io.github.PabloAlaniz由 GitHub 帳號 PabloAlaniz 發布v0.13.0更新於 Nov 7, 2026

Gmail, Calendar, Drive, Sheets, Tasks and Contacts for agents, with your own Google login

已驗證STDIO僅桌面效率與工作流溝通與協作資料與分析

概覽

AI 產生的概覽

本機 MCP 伺服器，讓助理用你自己的 Google Workspace 帳號處理 Gmail、日曆、雲端硬碟、試算表、工作和聯絡人。

可以做什麼
  • 查看登入狀態與已授權的權限範圍
  • 搜尋、讀取、寄送、回覆、轉寄、建立草稿、加標籤和移至垃圾桶的 Gmail 郵件
  • 列出、建立和刪除日曆活動，查詢空閒／忙碌時間
  • 搜尋、讀取、上傳和共用雲端硬碟檔案
  • 讀取、附加、更新和 upsert Google 試算表資料列
  • 列出、新增和完成工作，搜尋與管理聯絡人及群組
適用情境
適合希望助理在自己的 Google 帳號內整理郵件、安排會議、查看或修改試算表與雲端硬碟檔案、管理工作和聯絡人的情境，而不是使用共用的服務帳號。
執行需求
以 stdio 方式在本機執行，透過 uvx 啟動 PyPI 套件 gsuite-mcp。需要 Google Cloud 的 OAuth 用戶端 JSON 檔案，並用 gsuite CLI 完成一次登入以產生 tokens.db；需在 GSUITE_TOKEN_DB_PATH（必填）與 GSUITE_CREDENTIALS_FILE 填入絕對路徑，GSUITE_DEFAULT_TIMEZONE 為選用。行銷類工具需額外授權並在 Cloud 專案中啟用對應 API。
安裝前請注意
伺服器以你 Google 帳號的完整權限運作：工具可以寄送、轉寄、共用、覆寫和刪除郵件、檔案、活動、試算表資料列和聯絡人，執行寫入操作前應先確認。tokens.db 與 OAuth 用戶端檔案屬於憑證，應妥善保管。重新登入會取代已儲存的權限範圍，需重新列出所有要用的範圍。行銷類權限雖為唯讀，但仍會暴露分析資料。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Google Workspace (gsuite-sdk)，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

gsuite-mcp

An MCP server for Google Workspace: Gmail, Calendar, Drive, Sheets, Tasks and Contacts, built on gsuite-sdk. It runs locally over stdio and uses your own Google login.

Setup

  1. Get an OAuth client file from Google Cloud (guide) and log in once with the gsuite CLI:

    bash
    pip install "gsuite-sdk[cli]"gsuite auth login                                   # Gmail, Calendar, Drive, Sheetsgsuite auth login --force --scopes default,tasks,contacts   # + Tasks and Contactsgsuite auth login --force --scopes default,tasks,contacts,marketing  # + Search Console, GA4, Tag Manager (read-only)

    The token is saved to tokens.db in the current directory (or GSUITE_TOKEN_DB_PATH).

  2. Add the server to your MCP client, pointing at that token with absolute paths:

    json
    {  "mcpServers": {    "gsuite": {      "command": "uvx",      "args": ["gsuite-mcp"],      "env": {        "GSUITE_TOKEN_DB_PATH": "/Users/you/gsuite/tokens.db",        "GSUITE_CREDENTIALS_FILE": "/Users/you/gsuite/credentials.json",        "GSUITE_DEFAULT_TIMEZONE": "America/Argentina/Buenos_Aires"      }    }  }}

    Claude Code: claude mcp add gsuite -e GSUITE_TOKEN_DB_PATH=/Users/you/gsuite/tokens.db -- uvx gsuite-mcp

Tools

AreaTools
Accountauth_status
Gmailgmail_search, gmail_read, gmail_read_thread, gmail_list_labels, gmail_list_drafts, gmail_send, gmail_reply, gmail_forward, gmail_create_draft, gmail_send_draft, gmail_delete_draft, gmail_modify_labels (archive, read/unread, star, file), gmail_create_label, gmail_trash
Calendarcalendar_list_events, calendar_create_event, calendar_delete_event, calendar_free_busy
Drivedrive_search, drive_read_file, drive_upload, drive_share
Sheetssheets_read, sheets_append, sheets_update, sheets_upsert
Taskstasks_list, tasks_add, tasks_complete
Contactscontacts_search, contacts_get, contacts_list_groups, contacts_group_members, contacts_create_group, contacts_modify_group, contacts_delete_group
Search Console (read-only)searchconsole_list_sites, searchconsole_query, searchconsole_inspect_url, searchconsole_list_sitemaps
Analytics GA4 (read-only)analytics_account_summaries, analytics_list_properties, analytics_run_report, analytics_run_realtime_report
Tag Manager (read-only)tagmanager_list_accounts, tagmanager_list_containers, tagmanager_list_workspaces, tagmanager_list_tags, tagmanager_list_triggers, tagmanager_list_variables, tagmanager_list_versions

Search Console, Analytics and Tag Manager need the opt-in read-only scopes (--scopes ...,marketing) and their APIs enabled in your Cloud project. A login replaces the stored scopes, so keep listing the sets you already use.

Read tools are annotated read-only; tools that send, share, overwrite or delete are marked so clients can ask before running them. Dates are ISO 8601; times without an offset use GSUITE_DEFAULT_TIMEZONE (UTC by default).

The same capabilities are available as an agent skill, a CLI and a REST API: see gsuite-sdk.

License

MIT

來源：packages/mcp/README.md，提交 666ae3c

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

9
  1. v0.13.0最新Nov 7, 2026
  2. v0.10.0Nov 5, 2026
  3. v0.9.0Oct 23, 2026
  4. v0.7.0Oct 22, 2026
  5. v0.6.0Oct 17, 2026
  6. v0.5.2Oct 14, 2026
  7. v0.5.1Oct 14, 2026
  8. v0.5.0Oct 12, 2026
  9. v0.4.0Oct 10, 2026

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

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

  • 已宣告認證方式10 分

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

  • 已列出工具15 分

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

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