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, добавление тестовых пользователей и настройку URI перенаправления OAuth, что может быть довольно хлопотно.
• !Для удаленного использования или запуска в Docker с веб-клиентом OAuth потребуется доменное имя, поскольку IP-адреса нельзя указывать в URI перенаправления.

Темы

Частые вопросы

Что такое gmail-cleaner?

Бесплатный Python-инструмент с открытым исходным кодом, который запускается локально и позволяет массово отписываться от рассылок, удалять письма по отправителю и помечать письма в Gmail как прочитанные. Gmail Cleaner — локальное веб-приложение для наведения порядка во входящих Gmail. Оно помогает находить рассылки и отписываться от них, проверять, от каких отправителей вам чаще всего приходят письма, а также массово удалять или архивировать их сообщения. Кроме того, приложение позволяет массово помечать непрочитанные письма как прочитанные, управлять ярлыками, помечать письма как важные и экспортировать метаданные отправителей в CSV.

gmail-cleaner можно использовать бесплатно? Какая у него лицензия?

gmail-cleaner распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

gmail-cleaner всё ещё поддерживается?

Обновлялся за последние 6 месяцев. Последний коммит в gmail-cleaner — 18 авг. 2026 г..

Для чего можно использовать 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