{"id":21588,"library":"monarchmoney","title":"Monarch Money API","description":"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.","status":"active","version":"0.1.15","language":"python","source_language":"en","source_url":"https://github.com/hammem/monarchmoney","tags":["monarch-money","finance","api-wrapper","personal-finance"],"install":[{"cmd":"pip install monarchmoney","lang":"bash","label":"Standard install"}],"dependencies":[],"imports":[{"note":"The correct import is the class MonarchMoney, not the module itself.","wrong":"import monarchmoney","symbol":"MonarchMoney","correct":"from monarchmoney import MonarchMoney"}],"quickstart":{"code":"from monarchmoney import MonarchMoney\n\nmm = MonarchMoney()\nmm.login(username='your-email', password='your-password')\naccounts = mm.get_accounts()\nprint(accounts)","lang":"python","description":"Initialize MonarchMoney, log in, and fetch accounts."},"warnings":[{"fix":"Run: rm -fR .mm in the directory where the session was saved, then re-authenticate.","message":"Saved sessions older than v0.1.14 may cause 403 errors. Delete the .mm session file if you encounter auth failures after upgrade.","severity":"breaking","affected_versions":">=0.1.14"},{"fix":"Use monarchmoney==0.1.15 in your requirements.txt or poetry.lock.","message":"The alpha/beta status of this library means the API may change without notice. Pin your version to avoid sudden breakage.","severity":"deprecated","affected_versions":"all"},{"fix":"Limit request frequency and avoid scraping; use as intended for personal finance management.","message":"The library uses an unsupported, unofficial API. Monarch Money may ban your account for excessive or abnormal usage.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Delete the .mm session file: rm -fR .mm and then call mm.login() again.","cause":"Monarch invalidated old saved sessions; session file is incompatible.","error":"HTTP 403 error after upgrading monarchmoney"},{"fix":"Install using pip: pip install monarchmoney","cause":"The library is not installed or installed in a different environment.","error":"ModuleNotFoundError: No module named 'monarchmoney'"},{"fix":"Use: from monarchmoney import MonarchMoney","cause":"Incorrect import statement; trying to use the module as a class.","error":"AttributeError: module 'monarchmoney' has no attribute 'MonarchMoney'"},{"fix":"Check your internet connection and ensure no proxy blocks requests to api.monarchmoney.com.","cause":"Network issue or API endpoint unreachable (e.g., invalid URL or proxy).","error":"requests.exceptions.ConnectionError: HTTPSConnectionPool"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}