Disclaimer: This is an unofficial, community-built CLI tool. It is not affiliated with, endorsed by, or supported by Monarch Money. Use at your own risk.
CLI for Monarch Money - access your financial data from the command line. Built for humans and AI agents.
Built on top of monarchmoneycommunity.
# One-liner (recommended)
curl -sSL https://raw.githubusercontent.com/theFong/mmoney-cli/main/install.sh | bash
# Or with a package manager
uv tool install mmoney # fast, modern
pipx install mmoney # stable, widely used
pip install mmoney # may require PATH setup# Interactive login (recommended - keeps password out of shell history)
mmoney auth login
# Or with MFA secret for full automation
mmoney auth login -e your@email.com -p yourpassword --mfa-secret YOUR_SECRETSee Authentication Methods for all options.
mmoney accounts list # List all accounts
mmoney transactions list --limit 10 # Recent transactions
mmoney cashflow summary # Income, expenses, savingsThis CLI is designed for use with Claude Code and other AI agents.
mkdir -p ~/.claude/commands && curl -o ~/.claude/commands/mmoney.md https://raw.githubusercontent.com/theFong/mmoney-cli/main/.claude/commands/mmoney.mdOnce installed, ask Claude Code things like:
- "Do I have enough liquid cash to cover 6 months of expenses?"
- "What's my savings rate this month vs last month?"
- "Am I on track with my budget? Where am I overspending?"
- "How much am I losing to subscriptions I might not need?"
- "What's my net worth trend over the past year?"
- "Show me my biggest spending categories - where can I cut back?"
- "If I lost my job today, how long could I sustain my current lifestyle?"
- "What percentage of my income is going to debt payments?"
Claude will combine multiple commands, do the math, and give you actionable insights.
Your credentials are safe when using Claude Code:
- Tokens stored in OS keychain (not accessible to agents)
- Passwords entered interactively (not in shell history)
- API responses contain only financial data (no credentials)
See Security for details.
mmoney accounts list | jq '.accounts[] | {name: .displayName, balance: .currentBalance}'mmoney transactions list --search "Amazon" --start-date 2024-01-01 --end-date 2024-12-31mmoney cashflow summary --timeframe last_monthmmoney transactions list --format csv > transactions.csvmmoney holdings list --format csvmmoney auth login # Login to Monarch Money
mmoney auth logout # Delete saved session
mmoney auth status # Check authentication statusmmoney accounts list # List all accounts
mmoney accounts types # List account types
mmoney accounts create # Create manual account
mmoney accounts update <id> # Update account
mmoney accounts delete <id> # Delete account
mmoney accounts refresh # Refresh from institutions
mmoney accounts refresh-status # Check refresh statusmmoney holdings list <account_id> # List holdings
mmoney holdings history <account_id> # Balance history
mmoney holdings snapshots # Aggregate snapshots
mmoney holdings balances # Recent balancesmmoney transactions list # List transactions
mmoney transactions get <id> # Get transaction details
mmoney transactions summary # Transaction summary
mmoney transactions splits <id> # Get splits
mmoney transactions create # Create transaction
mmoney transactions update <id> # Update transaction
mmoney transactions delete <id> # Delete transactionmmoney categories list # List categories
mmoney categories groups # List category groups
mmoney categories create # Create category
mmoney categories delete # Delete categorymmoney tags list # List tags
mmoney tags create # Create tag
mmoney tags set <transaction_id> # Set tags on transactionmmoney budgets list # List budgets
mmoney budgets set # Set budget amountmmoney cashflow summary # Income, expenses, savings
mmoney cashflow details # By category and merchantmmoney recurring list # Recurring transactions
mmoney institutions list # Linked institutions
mmoney subscription status # Subscription detailsMost list commands support:
--limit,-l: Number of records--start-date,-s: Start date (YYYY-MM-DD)--end-date,-e: End date (YYYY-MM-DD)--format,-f: Output format (json, csv, jsonl, text)
Recommended methods in order of preference:
| Method | Flag | Best for |
|---|---|---|
| MFA Secret | --mfa-secret |
Full automation, long-lasting |
| MFA Code | --mfa-code |
Manual entry, secure |
| Device UUID | --device-uuid |
Bypasses MFA |
| Token | --token |
Quick testing, shortest lived |
Get Device UUID:
# In browser console at app.monarchmoney.com:
copy(localStorage.getItem('monarchDeviceUUID'))Get Token:
# In browser Network tab, find 'Authorization: Token YOUR_TOKEN' headerRun mmoney auth login --help for detailed instructions.
Sessions are stored securely using your system's keychain:
- macOS: Keychain
- Windows: Credential Manager
- Linux: Secret Service
Falls back to ~/.mmoney/session.pickle if keychain is unavailable.
- Command Reference - Complete guide to all commands
- JSON Schemas - Output schemas for agent integration
- Security - Credential storage and AI agent safety
# Clone the repo
git clone https://github.com/theFong/mmoney-cli.git
cd mmoney-cli
# Full setup (installs uv, deps, git hooks)
./scripts/setup-dev.sh
# Or use VS Code devcontainer
# Open in VS Code and click "Reopen in Container"Quick commands:
uv run mmoney --help # Run the CLI
uv run pytest tests/ # Run tests
./scripts/setup-dev.sh lint # Run all linters
./scripts/setup-dev.sh test # Run tests- Update version in
pyproject.toml - Commit and push to main
- Either:
- Create a GitHub release:
gh release create vX.Y.Z(auto-publishes to PyPI) - Manual: Run the publish workflow
- Create a GitHub release:
MIT