Gururagavendra/gmail-cleaner

これは何？

主な機能

• 011つの画面からメルマガの登録を一括解除
• 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 の設定が必要で、少し手間がかかる場合があります。
• !Web OAuth クライアントを使ってリモート環境または Docker で利用する場合、リダイレクト URI に IP アドレスを指定できないため、ドメイン名が必要です。

トピック

よくある質問

gmail-cleaner とは？

Gmailのメルマガ一括登録解除、送信者別のメール削除、既読化をローカルで実行できる、無料のセルフホスト型Pythonツールです。 Gmail Cleanerは、Gmailの受信トレイを整理するローカルWebアプリです。メルマガを見つけて登録解除したり、メールを頻繁に送ってくる送信者を調べたり、送信者ごとのメールを一括削除またはアーカイブしたりできます。大量の未読メールを既読にするほか、ラベルの管理、メールへの重要マークの付与、送信者のメタデータの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