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 설정이 필요해 다소 번거로울 수 있습니다.
• !웹 OAuth 클라이언트를 사용해 원격 환경이나 Docker에서 이용하려면 도메인 이름이 필요합니다. 리디렉션 URI에 IP 주소를 사용할 수 없기 때문입니다.

토픽

자주 묻는 질문

gmail-cleaner은(는) 무엇인가요?

Gmail에서 뉴스레터를 일괄 구독 취소하고, 발신자별 이메일을 삭제하고, 이메일을 읽음으로 표시하는 무료 로컬 실행형 셀프 호스팅 Python 도구입니다. Gmail Cleaner는 Gmail 받은편지함을 정리하는 로컬 웹 앱입니다. 뉴스레터를 찾아 구독을 취소하고, 이메일을 가장 자주 보내는 발신자를 확인하고, 해당 발신자의 메시지를 일괄 삭제하거나 보관할 수 있습니다. 읽지 않은 이메일을 대량으로 읽음 처리하고, 라벨을 관리하고, 메시지를 중요 표시하고, 발신자 메타데이터를 CSV로 내보내는 기능도 지원합니다.

gmail-cleaner은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

gmail-cleaner은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

gmail-cleaner은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. 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