Skip to content

v0.1.0 - Initial Release

Choose a tag to compare

View all tags
@theFong theFong released this 21 Jan 21:53
· 55 commits to main since this release
v0.1.0
0cfeec7

mmoney-cli v0.1.0

First release of the Monarch Money CLI - a command-line interface for the Monarch Money API, designed for AI agent consumption.

Features

Authentication

  • Multiple auth methods: token, MFA code, MFA secret (TOTP), device UUID
  • Secure token storage in system keychain (macOS Keychain, Windows Credential Manager, etc.)
  • Fallback to ~/.mmoney/session.pickle if keychain unavailable

Commands

  • accounts: list, types, create, update, delete, refresh
  • transactions: list, get, create, update, delete, summary, splits
  • holdings: list, history, snapshots, balances
  • categories: list, groups, create, delete
  • tags: list, create, set
  • budgets: list, set
  • cashflow: summary, details
  • recurring: list
  • institutions: list
  • subscription: details

Agent-Friendly Output

  • Multiple formats: --format json|jsonl|csv|text
  • Default: text (key=value pairs)
  • Structured JSON error responses with exit codes

Safety

  • Read-only by default
  • Mutation commands require --allow-mutations flag
  • Confirmation required for destructive operations

Installation

pip install mmoney-cli

Usage

# Login
mmoney auth login --token YOUR_TOKEN

# List accounts
mmoney accounts list

# Get transactions as JSON
mmoney -f json transactions list --limit 10
Assets 2
Loading