Registry / crm-productivity / monarchmoney

monarchmoney

library0.1.15pypypi✓ verified 85d ago

An unofficial Python wrapper for the Monarch Money GraphQL API. Version 0.1.15 provides access to accounts, transactions, budgets, categories, and more. Release cadence is irregular, with frequent bugfixes for API changes.

crm-productivity http-networking

pip install monarchmoney

github ↗package ↗

INSTALL

IMPORT

SIG · MONARCHMONEY

monarchmoney

crm-productivitypythonv0.1.15

Install

4.6s avg

Import

802ms

Disk

32MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.1.15 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.840s · 31.9MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 4.6s · import 0.764s · 34MB

32MB installed

● package 32MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

MonarchMoney

✓ from monarchmoney import MonarchMoney

✗ import monarchmoney

The correct import is the class MonarchMoney, not the module itself.

Initialize MonarchMoney, log in, and fetch accounts.

from monarchmoney import MonarchMoney mm = MonarchMoney() mm.login(username='your-email', password='your-password') accounts = mm.get_accounts() print(accounts)

Debug

Known issues

breakingSaved sessions older than v0.1.14 may cause 403 errors. Delete the .mm session file if you encounter auth failures after upgrade.

fix

Run: rm -fR .mm in the directory where the session was saved, then re-authenticate.

affects: >=0.1.14

deprecatedThe alpha/beta status of this library means the API may change without notice. Pin your version to avoid sudden breakage.

fix

Use monarchmoney==0.1.15 in your requirements.txt or poetry.lock.

affects: all

gotchaThe library uses an unsupported, unofficial API. Monarch Money may ban your account for excessive or abnormal usage.

fix

Limit request frequency and avoid scraping; use as intended for personal finance management.

affects: all

Errors

Common errors & fixes

HTTP 403 error after upgrading monarchmoney

Monarch invalidated old saved sessions; session file is incompatible.

fix

Delete the .mm session file: rm -fR .mm and then call mm.login() again.

ModuleNotFoundError: No module named 'monarchmoney'

The library is not installed or installed in a different environment.

fix

Install using pip: pip install monarchmoney

AttributeError: module 'monarchmoney' has no attribute 'MonarchMoney'

Incorrect import statement; trying to use the module as a class.

fix

Use: from monarchmoney import MonarchMoney

requests.exceptions.ConnectionError: HTTPSConnectionPool

Network issue or API endpoint unreachable (e.g., invalid URL or proxy).

fix

Check your internet connection and ensure no proxy blocks requests to api.monarchmoney.com.

Upgrade

Version history

0.1.15latest on PyPI · released Jan 29, 2025

Audit

Dependencies

No dependency data recorded yet.

Agent activity

41 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/hammem/monarchmoney ↗

packagehttps://pypi.org/project/monarchmoney/ ↗