Monarch Money CLI 🦋

Query your finances from the terminal. Accounts, transactions, budgets, cashflow — one command away.

---

• Full API coverage — accounts, transactions, budgets, cashflow, categories, tags, recurring, institutions
• Agent-friendly — JSON output by default, structured for scripts and AI agents
• Human-friendly — --format table for readable output, interactive auth with MFA
• Long-lived sessions — trusted device support for non-expiring tokens

Quick Start

git clone https://github.com/Maninae/monarch-money-cli.git
cd monarch-money-cli
pip install -e .

monarch auth login                  # interactive — prompts for email, password, MFA
monarch accounts list               # JSON by default
monarch accounts list --format table # human-readable
monarch transactions list --limit 20
monarch cashflow summary

Commands

Group	Commands
auth	login logout status
accounts	list get holdings history refresh refresh-status types create update delete
transactions	list get summary create update delete splits
budgets	list set
cashflow	summary details
categories	list groups create delete
tags	list create set
recurring	list
institutions	list subscription

Every command supports --help for full usage details.

Output Formats

monarch accounts list                 # JSON (default)
monarch accounts list --format table  # table

JSON output works well with jq for scripting:

monarch transactions list --limit 100 | jq '.allTransactions.results[].amount'

Configuration

File	Contents	Permissions
~/.monarch/session.json	Auth token (pickle format)	600
~/.monarch/	Session directory	700

Security

• All credentials are entered interactively — nothing leaks to shell history or process lists.
• Session file is created with restricted permissions (600). Treat ~/.monarch/ like any credential store.
• Logging out (monarch auth logout) clears the local session file but does not revoke the token server-side.

Dependencies

Built on the monarchmoney Python library. Uses a patched fork with API domain migration and gql 4.0 compatibility fixes applied.

License

Non-Commercial Personal Use License — free to use, copy, modify, and share for personal, non-commercial purposes. See LICENSE for details.