Gururagavendra/gmail-cleaner

这是什么？

核心功能

• 01在统一界面中批量退订订阅邮件
• 02按发件人删除邮件，支持同时处理多个发件人并显示进度
• 03可按日期范围、邮件大小、Gmail 分类、发件人和标签筛选
• 04批量标记已读、归档、添加或移除标签、标记重要邮件
• 05将发件人邮件元数据导出为 CSV
• 06支持 Docker 或 Python 本地运行，使用自己的凭据

适用场景

• 清理充斥促销邮件和订阅通知的收件箱
• 批量清除多年来几个高频发件人的邮件
• 一次性将大量旧的未读邮件标为已读
• 在决定退订前，先查看哪些发件人发信最多

快速上手

1. 1

   克隆仓库

   git clone https://github.com/Gururagavendra/gmail-cleaner.git
2. 2

   进入项目文件夹

   cd gmail-cleaner
3. 3

   使用 uv 安装依赖

   uv sync
4. 4

   运行应用并打开 http://localhost:8766

   uv run python main.py

使用前须知

• !使用前必须自行创建 Google Cloud OAuth 凭据（credentials.json）。
• !设置需要在 Google Cloud Console 中配置测试用户和 OAuth 重定向 URI，步骤较繁琐。
• !通过 Docker 或远程服务器使用网页版 OAuth 客户端时需要域名，Google 不允许使用 IP 地址作为重定向 URI。

标签

常见问题

gmail-cleaner 是什么？

一款免费、本地运行的 Python 工具，可批量退订邮件、按发件人删除邮件并标记已读。 Gmail Cleaner 是一个在本地运行的网页应用，用于整理 Gmail 收件箱。它可以找出订阅邮件并一键退订，统计哪些发件人发邮件最多，并按发件人批量删除或归档邮件。此外还支持批量标记已读、管理标签、标记重要邮件，以及将发件人邮件元数据导出为 CSV。

gmail-cleaner 可以免费使用吗？用的什么许可证？

gmail-cleaner 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

gmail-cleaner 还在维护吗？

半年内有更新。gmail-cleaner 最近一次提交是在 2026年8月18日。

gmail-cleaner 适合用来做什么？

清理充斥促销邮件和订阅通知的收件箱 批量清除多年来几个高频发件人的邮件 一次性将大量旧的未读邮件标为已读 在决定退订前，先查看哪些发件人发信最多

gmail-cleaner 怎么安装和运行？

克隆仓库: git clone https://github.com/Gururagavendra/gmail-cleaner.git 进入项目文件夹: cd gmail-cleaner 使用 uv 安装依赖: uv sync 运行应用并打开 http://localhost:8766: uv run python main.py

在哪里获取 gmail-cleaner？

源代码和安装说明在 GitHub 上：https://github.com/Gururagavendra/gmail-cleaner