notoriouslab

notoriouslab / gmail-statement-fetcher

Public

Downloads bank statement PDFs from Gmail. Config-driven — add any bank via JSON, no code changes. IMAP or OAuth 2.0.自動從 Gmail 下載銀行對帳單 PDF。規則由 JSON 設定檔驅動，新增銀行不需改程式碼。支援 IMAP 與 OAuth 2.0，內建去重機制。

automation bank-statement gmail imap oauth
10
2
100% credibility
Found Mar 14, 2026 at 10 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

A script that automatically downloads, organizes, and deduplicates bank statement PDFs from Gmail emails using customizable rules for multiple banks.

How It Works

1
🕵️ Discover the Tool

You're tired of manually saving bank statements from Gmail emails and find this handy helper that automates it for you.

2
📥 Get It Ready

Download the program to your computer and make a copy of the example setup to start customizing.

3
✏️ Add Your Banks

Edit the simple list to include your banks' email senders and keywords so it knows what to look for.

4
Connect Your Gmail
🔑
Quick Password Setup

Create a special secure password in your Google settings for easy, no-browser access.

✅
Browser Approval

Approve it once in your web browser for read-only access that's extra secure.

5
👀 Preview Matches

Run a test to see exactly which emails it finds and what neat filenames it plans, without downloading anything.

6
▶️ Fetch Statements

Hit go, and it grabs the PDFs, unzips if needed, unlocks passwords, and saves them neatly organized by bank and date.

📁 Organized Files Ready

Relax with your statements safely stored in easy-to-find files, ready for budgeting or taxes, and set it to run automatically anytime.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 10 to 10 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is gmail-statement-fetcher?

Gmail-statement-fetcher is a Python script that pulls bank statement PDFs from Gmail inboxes, matching emails via JSON config rules for senders and subjects. Add any bank—like Aareal Bank downloads, Deutsche Bank downloads, or BMW Bank downloads—without code changes; it supports IMAP for headless servers or OAuth 2.0 for personal setups, extracts ZIPs, decrypts PDFs, normalizes filenames (e.g., "Bank_Statement_2024_02.pdf"), and dedups via UID tracking. It ends the monthly email scavenger hunt for statements from FNZ Bank or Bank11 downloads.

Why is it gaining traction?

Stands out with pure config-driven rules—no recoding to add L Bank downloads or Wi Bank downloads—plus dry-run previews, atomic writes, and privacy-safe dedup using subject hashes. Cron-ready with dotenv support, it beats github downloads slow or github downloads extremely slow by running locally, and security caps ZIP bombs while masking logs. Devs grab it for multi-bank flexibility over single-script hacks.

Who should use this?

Personal finance hackers automating cron jobs for banksy downloads or downloads bank burgenland statements. Python users building budgeting pipelines, skipping manual grabs for taxes. DevOps folks piping outputs to tools, avoiding github downloads stats tracking or github downloads very slow issues.

Verdict

Grab it for Gmail-based bank automation—top-notch docs and features like --dry-run make setup fast—but 10 stars and 1.0% credibility score signal early maturity; run tests first. Solid starter if your banks email PDFs.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.