安裝
pip install "gigamail[all]"適合誰
適合需要讓助手在權限模型下碰信箱、行事曆和本機知識檔案的人。GigaMail 走 MCP，說明點名 Claude、Codex、OpenClaw、Hermes，以及其他 MCP 宿主。能力包括多帳戶（Microsoft Graph + IMAP）、行事曆、本機搜尋索引、寄件者記憶，以及面向助手的權限控制。它自己不帶模型，智力來自你的助手。
硬前提有兩層。先用 pip 裝好帶 extras 的套件，再由人類在自己的終端裡完成信箱接入；助手不得代勞。接入命令是 gigamail login 與 gigamail accounts add-imap，會要憑證。沒有人類先登入，後面的讀寫都沒有帳戶可指。
不適合想讓助手自己完成 OAuth 或 IMAP 密碼錄入的人，也不適合把「stdio 不監聽連接埠」理解成沒有任何本機服務的人：可選的人類主控台會在 127.0.0.1 上開 HTTP。
3 分鐘完成第一次嘗試
官方安裝：
pip install "gigamail[all]"
設定位置在 Claude Desktop / Claude Code 的 mcpServers。command 為 gigamail-server，不必再寫連接埠。MCP 本身只走 stdio，不監聽網路連接埠。
安裝後先離開助手，在你自己的 shell 裡執行 gigamail login（或 IMAP 的 gigamail accounts add-imap）。說明寫明這必須由人類完成，而且系統設計成無法透過助手去做。憑證不要貼進聊天。
宿主拉起 gigamail-server 後，第一次只做讀取。說明把工具分成唯讀、可稽核的安全寫入，以及 6 個危險動作。危險組包括 send、reply、delete message、delete folder、create/delete calendar event，需要帶外的人類核准。第一次不要碰這 6 個。成功訊號是唯讀呼叫回傳了你帳戶裡可見的郵件或行事曆摘要，而不是彈出發送確認。唯讀仍會看到真實收件匣，不是零風險。
使用案例
案例一：在已登入的帳戶裡檢索郵件或行事曆。說明強調本機搜尋索引和受控的信箱存取，並寫到有一批唯讀工具。適合「先找一封信、先看今天的行程」。現有說明沒有列出唯讀工具的具體名字和參數，不要自行編 search 或 list 命令。能確認的是：多帳戶、Graph 與 IMAP、以及本機索引存在。
案例二：傳送、回覆、刪信、刪資料夾或建立/刪除行事曆事件。這些被標成 Dangerous，共 6 個，必須帶外人類核准。適合真的要改信箱或行程、並且人就在旁邊確認的場景。呼叫前先認定確認點：人類在帶外核准之前，郵件不應出去、事件不應寫上。現有說明沒有給出核准介面或逾時，也沒有撤銷已傳送郵件的步驟。
使用邊界
信箱登入不能透過助手完成。MCP 只講 stdio、不監聽連接埠，但可選主控台會綁到 127.0.0.1 的 HTTP，不能理解成「無網路、無本機介面」。郵件、行事曆和知識檔案都是真實資料，權限模型降低的是誤操作，不是消除讀取。
危險動作固定是那 6 類，需要帶外核准。其餘寫入被概括為可稽核的安全寫入，沒有逐條點名。沒有內建模型，品質取決於你的助手。現有說明沒有配額、廠商限流或解除帳戶的完整步驟。把憑證交給 gigamail login 之後，任何能驅動該 MCP 的宿主都可能讀到同一箱郵件。