A local, agent-friendly command-line tool for Monarch Money.
monarchmoney-cli is a production-focused Go implementation of a Monarch Money interface. It allows you to query, manage, and automate your financial data directly from your terminal or via AI Agents.
- 🤖 Agent-First: Stable JSON output, distinct stdout/stderr, and predictable exit codes.
- 🛡️ Safety First: Multi-tiered safety model with
--read-only,--dry-run, and--confirmgates. - 📜 Auditable: Local JSONL audit logs for every remote mutation.
- ⚡ Performance: Single-binary implementation in Go with optional SQLite caching.
- 🧩 Comprehensive: Full feature parity with monarch-mcp-server — accounts, transactions, budgets, cashflow, rules, splits, and more.
Via Homebrew Cask (macOS/Linux):
brew install --cask thedavidweng/tap/monarchmoney-cliIf you installed the old Homebrew formula, migrate to the cask:
brew update
brew uninstall --formula thedavidweng/tap/monarchmoney-cli
brew install --cask thedavidweng/tap/monarchmoney-cli
monarch versionVia Go (Cross-platform):
go install github.com/thedavidweng/monarchmoney-cli/cmd/monarch@latestmonarch doctormonarch auth login# List all accounts in JSON format
monarch accounts list --json
# Search for transactions
monarch transactions search "Amazon" --from 2024-01-01 --json
# List transactions needing review
monarch transactions list --needs-review --json
# View auto-categorization rules
monarch rules list --json
# Get spending breakdown
monarch cashflow spending --from 2024-01-01 --to 2024-01-31 --jsonDetailed guides are available in the /docs directory:
- 🛠️ Capabilities: Full list of supported commands and features.
- 🔐 Safety Model: How we protect your financial data.
- 🔑 Authentication: MFA support and session management.
- 🤖 Agent Integration: Guide for connecting with AI Agents.
- 📊 JSON Schema: Stable output contract details.
money is an open-source, self-hosted, fully local personal finance backend. It borrows many interaction patterns from monarchmoney-cli: the same JSON-first CLI, the same safety gates. The key difference is that it runs entirely on your own machine with no subscription required. If you've ever wanted a fully autonomous alternative, it might be worth a look.
We welcome contributions! Please see our Contributing Guide for details on how to get started.
monarchmoney-cli is an independent, community-maintained project and is not affiliated with, sponsored by, or endorsed by Monarch Money, Inc.
This project builds on work and ideas from the following projects:
hammem/monarchmoney— The original Python API project for accessing Monarch Money data.bradleyseanf/monarchmoneycommunity— The maintained community fork that documents and extends the current unofficial Monarch Money API surface.
Distributed under the Apache License 2.0. See LICENSE for more information.
Built with ❤️ for the Monarch Money community.