---
id: monarchmoneycommunity
version: "1.5.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# monarchmoneycommunity — Monarch Money API for Python

License: permissive · Maintenance: active · Downloads: 91.3K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 91.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

monarch money python api, personal finance data access, account aggregation library, transaction management sdk, budget tracking integration, financial data sync, monarch money client, financial-data, api-client, async

[View on SkillFed](https://skillfed.io/packages/monarchmoneycommunity) · [View on PyPI](https://pypi.org/project/monarchmoneycommunity/)