monarchmoneycommunity

What it is and what it does

Monarchmoneycommunity is a Python wrapper around the Monarch Money financial aggregation platform's GraphQL API. It handles authentication including multi-factor authentication, session management, and provides both interactive and non-interactive login flows. The library exposes methods to read account data, transaction history, budgets, cashflow summaries, and credit information, as well as mutating operations to create, update, and delete transactions, categories, budgets, and accounts.

The package depends on aiohttp for HTTP communication, gql pinned to 4.0 for GraphQL queries, and oathtool for MFA token generation. It is designed for async/await patterns and supports session persistence so that repeated logins are not required. A typed variant is also available for developers who want structured return types instead of raw dictionaries.

Use it for:

• Export and analyze personal financial data from Monarch Money into custom dashboards or reporting tools
• Automate transaction categorization, tagging, or reconciliation workflows programmatically
• Sync budget targets and actual spending data into external budgeting or accounting systems
• Build monitoring alerts for account balance changes or unusual transaction patterns
• Aggregate data from multiple linked institutions via Monarch Money's Plaid integration

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Python client library for querying and managing Monarch Money accounts, transactions, budgets, and financial data via the Monarch Money API.

Yes, with conditions. The library is actively maintained, has low install friction, and offers a comprehensive API surface for Monarch Money automation. However, it depends on the stability and availability of Monarch Money's undocumented GraphQL endpoint; changes to that API could break the library. Suitable for personal finance automation and integration projects where you control the Monarch Money account and can tolerate potential upstream API changes.

Install

monarchmoneycommunity on PyPI

pip install monarchmoneycommunity

uv add monarchmoneycommunity

poetry add monarchmoneycommunity

Installing monarchmoneycommunity

Before you install

Low install friction with a pure-Python wheel distribution. Actively maintained as of 2026-08-09 with recent releases; the project is a community fork that fixes issues in the upstream library and remains under active development.

License in practice

MIT license permits commercial and private use with minimal restrictions, making it suitable for both personal projects and commercial applications.

Quickstart

pip install monarchmoneycommunity

from monarchmoney import MonarchMoney

mm = MonarchMoney()
await mm.login(email='user@example.com', password='password')
accounts = await mm.get_accounts()

Requires async/await context (event loop); Monarch Money credentials and account access; gql pinned to 4.0

Verify before relying

• Whether session persistence reliably lasts the multi-month window mentioned in documentation
• Performance characteristics when handling large transaction or account datasets
• Stability of the Monarch Money API surface that this library wraps

Package facts

Evidence: monarchmoneycommunity-1.5.2-py3-none-any.whl

Keywords: monarch money, financial, money, personal finance

Tags

More Financial packages