「Gmail Cleaner」开源本地 Gmail 清理工具：批量退订、按发件人删除并标记已读

Gmail Cleaner 是一个面向 Gmail 的开源本地清理工具，目标很直接：把批量退订、按发件人删除、标记已读、归档、标签管理和邮件元数据导出这些高频清理动作，放到一个本机运行的 Web GUI 里完成。

它适合那种“邮箱已经积压多年、搜索和手动删除都太慢”的场景。项目提供 Docker 和 Python/uv 两种运行方式，启动后默认在 http://localhost:8766 使用；清理动作通过 Gmail API 批量请求执行，而不是让你在 Gmail 网页里一页页点。

把邮箱清理放回本地

Gmail Cleaner 的隐私边界相对清楚：它要求用户创建自己的 Google Cloud OAuth 凭据，授权 Gmail 读取和修改权限，数据处理在本机完成，不通过第三方服务器。仓库也明确把凭据与 token 文件放进 gitignore，避免误提交。

功能上，它支持按发件人批量删除、批量退订、标记已读、归档、标签管理、重要邮件标记、CSV 元数据导出，以及按日期、大小、分类、发件人和标签过滤邮件。删除邮件会进入 Gmail Trash，通常仍可在 30 天内恢复，但批量操作前仍建议先用过滤条件确认范围。

更适合愿意自管授权的人

如果你愿意自己创建 OAuth app，并希望邮箱清理过程不交给陌生 SaaS，Gmail Cleaner 会比浏览器插件或第三方清理服务更可控。它不是“免配置”的消费级产品，更像给熟悉本地运行和 Google API 授权流程的人准备的 Gmail 大扫除工具。

截至 2026-06-05，项目在 GitHub 上约有 1,873 stars，主要语言为 Python，采用 MIT License；仓库最近推送记录显示为 2025-12-29。

来源：GitHub 仓库、项目主页