Skip to main content

monarch-converter

I wrote a script to convert transactions downloaded from Mint so they could be uploaded into Monarch Money

Installation

pip install monarch-converter

Usage

This script assumes you have a csv file downloaded from Mint.com before they shut down.

Reading basic information

monarch-converter mint-transactions.csv

Translating account names

There may be situations where an account name in Mint does not match what you want to use in Monarch. These can be renamed in bulk with a csv file.

A helper has been created to format that csv file.

# create a helper csv - this will create a csv with duplicate account names
monarch-converter mint-transactions.csv --account-mapping-helper rename-accounts.csv

Just edit the Monarch column to use whatever account name you'd like, and then use it for the next step.

# this will read in the rename-accounts csv file, renaming account names as defined
monarch-converter mint-transactions.csv --account-mapping-translate rename-accounts.csv

Output

Monarch Money requested a separate csv file for each account, so the data can be partitioned and chunked up. By default, the max row count is 5000, but that is adjustable.

The output is specified by directory.

monarch-converter mint-transactions.csv --account-mapping-translate rename-accounts.csv --output ./output/ --max-rows 5000

Metadata

Release files for monarch-converter 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for monarch-converter 0.1.0
File Size Uploaded
monarch_converter-0.1.0.tar.gz 12.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for monarch-converter 0.1.0
File Interpreter ABI Platform
monarch_converter-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 17.4 kB

Release files / monarch_converter-0.1.0.tar.gz

Download URL monarch_converter-0.1.0.tar.gz
Size 12.2 kB
Tags Source
SHA-256 checksum
How to use checksums
5741fda148a863ecece16455a945b7b733e6a91295025a9b4be8cac541dfdec4
BLAKE2b-256 checksum
How to use checksums
329d7e223a6fbdf8025c3070d5cff0e9b508dde762e5ae0642a8605accb07455
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 2, 2025.

Transparency log

Release files / monarch_converter-0.1.0-py3-none-any.whl

Download URL monarch_converter-0.1.0-py3-none-any.whl
Size 5.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8e3349ef13315555e4106b2ece72d02f995ae081bf97ae7dee741679d8357190
BLAKE2b-256 checksum
How to use checksums
5d498bc8415d0add121b394c90f24fa35065bbe641242378525e1059c097c89b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 2, 2025.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page