Monopoly is a Python library & CLI that converts bank statement PDFs to CSV.
Supported banks:
| Bank | Credit Statement | Debit Statement |
|---|---|---|
| Bank of America | ✅ | ✅ |
| Bank of Montreal (BMO) | ✅ | ✅ |
| Canadian Imperial Bank of Commerce (CIBC) | ✅ | ✅ |
| Canadian Tire Bank | ✅ | ❌ |
| Capital One Canada | ✅ | ❌ |
| Chase | ✅ | ❌ |
| Citibank | ✅ | ❌ |
| DBS/POSB | ✅ | ✅ |
| HSBC | ✅ | ❌ |
| Maybank | ✅ | ✅ |
| OCBC | ✅ | ✅ |
| Royal Bank of Canada (RBC) | ✅ | ✅ |
| Schwab Bank | N/A | ✅ |
| Scotiabank | ✅ | ✅ |
| Standard Chartered | ✅ | ❌ |
| TD Canada Trust | ✅ | ✅ |
| Trust | ✅ | ❌ |
| UOB | ✅ | ✅ |
| US Bank | ✅ | ❌ |
| Zürcher Kantonalbank | ❌ | ✅ |
Install
Monopoly is a pip-installable Python package on PyPI under the name monopoly-core.
Since Monopoly uses pdftotext, you'll need to install additional dependencies:
apt-get install build-essential libpoppler-cpp-dev pkg-config ocrmypdf
or
brew install gcc@11 pkg-config poppler ocrmypdf
Then install with pipx:
pipx install monopoly-core
For additional OCR support:
pipx install 'monopoly-core[ocr]'
Usage
Monopoly runs in your terminal, allowing you to extract, transform and write bank statements to a CSV file.
To list commands and options:
monopoly --help
You can run it on a single statement
monopoly src/monopoly/examples/example_statement.pdf
or multiple statements
monopoly ./statements
To keep the output filename the same as the input (with a .csv extension), pass:
monopoly path/to/file.pdf --output ./out --preserve-filename
By default Monopoly writes a 4-column CSV. Pass --format json for a richer,
versioned schema (schema_version, statement metadata, payment summary, and a
stable per-transaction id):
monopoly path/to/file.pdf --output ./out --format json
Each transaction also carries currency (the statement's settlement currency),
posting_date, a normalized direction ("credit"/"debit"), and a nullable
account slot. Per-transaction FX/original-currency and account last-4 extraction
are a planned follow-up (currently null).
If you need to run monopoly on a password protected file, ensure that passwords are set in the .env file:
cp .env.template .env
PDF_PASSWORDS=["password1","password2"]
Monopoly can also be run as a Python library:
python3 src/monopoly/examples/single_statement.py
Features
- Parses PDFs using predefined configuration classes per bank.
- Handles locked PDFs with credentials passed via environment variables.
- Supports adding OCR for image-based bank statements.
- Provides a generic parser that can be used without any predefined configuration (caveat emptor).
- Includes a safety check (enabled by default) that validates totals for debit or credit statements.
Development
Clone the repo
git clone https://github.com/benjamin-awd/monopoly.git
Install dependencies using Homebrew
brew install make
make setup
brew bundle
1 maintainer
Metadata
1 maintainer
Release files for monopoly-core 0.22.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| monopoly_core-0.22.0.tar.gz | 3.8 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| monopoly_core-0.22.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 4.1 MB
Release files / monopoly_core-0.22.0.tar.gz
| Download URL | monopoly_core-0.22.0.tar.gz |
|---|---|
| Size | 3.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9265eaa730b0839cfe94e67c0b0d9cb2ba95ad112aa188ab3089f8d02c7d12d1
|
|
BLAKE2b-256 checksum How to use checksums |
89cccf4e6d7c3364ea98fae6df9f86da9176ab94b4116b9f98535b4de2b0e7b7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / monopoly_core-0.22.0-py3-none-any.whl
| Download URL | monopoly_core-0.22.0-py3-none-any.whl |
|---|---|
| Size | 282.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3ac0ce250ea4983361bb5faf423c598204bc937e278daa8ccd43ab8c65d6dfe9
|
|
BLAKE2b-256 checksum How to use checksums |
45226079efe6dca6a0c3a53a0df18e2670f5ac0d7e24466815277604838bb2df
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
