安装
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 的宿主都可能读到同一箱邮件。