monarch-moneyTypeScript library and CLI for Monarch Money budget management. Search transactions by date/merchant/amount, update categories, list accounts and budgets, manage authentication. Use when user asks about Monarch Money transactions, wants to categorize spending, needs to find specific transactions, or wants to automate budget tasks.
Install via ClawdBot CLI:
clawdbot install davideasaf/monarch-moneyCLI and TypeScript library for Monarch Money budget automation.
| Variable | Required | Description |
|----------|----------|-------------|
| MONARCH_EMAIL | Yes | Monarch Money account email |
| MONARCH_PASSWORD | Yes | Monarch Money account password |
| MONARCH_MFA_SECRET | Yes | TOTP secret for MFA (see below) |
Monarch Money requires MFA. Generate the TOTP secret:
JBSWY3DPEHPK3PXP)export MONARCH_MFA_SECRET="YOUR_SECRET"# Check setup
monarch-money doctor
# Login (uses env vars by default)
monarch-money auth login
# List transactions
monarch-money tx list --limit 10
# List categories
monarch-money cat list# Login with environment variables
monarch-money auth login
# Login with explicit credentials
monarch-money auth login -e email@example.com -p password --mfa-secret SECRET
# Check auth status
monarch-money auth status
# Logout
monarch-money auth logout# List recent transactions
monarch-money tx list --limit 20
# Search by date
monarch-money tx list --start-date 2026-01-01 --end-date 2026-01-31
# Search by merchant
monarch-money tx list --merchant "Walmart"
# Get transaction by ID
monarch-money tx get <transaction_id>
# Update category
monarch-money tx update <id> --category <category_id>
# Update merchant name
monarch-money tx update <id> --merchant "New Name"
# Add notes
monarch-money tx update <id> --notes "My notes here"# List all categories
monarch-money cat list
# List with IDs (for updates)
monarch-money cat list --show-ids# List accounts
monarch-money acc list
# Show account details
monarch-money acc get <account_id># Run diagnostic checks
monarch-money doctorChecks:
Import and use the TypeScript library directly:
import { MonarchClient } from 'monarch-money';
const client = new MonarchClient({ baseURL: 'https://api.monarch.com' });
// Login
await client.login({
email: process.env.MONARCH_EMAIL,
password: process.env.MONARCH_PASSWORD,
mfaSecretKey: process.env.MONARCH_MFA_SECRET
});
// Get transactions
const transactions = await client.transactions.getTransactions({ limit: 10 });
// Get categories
const categories = await client.categories.getCategories();
// Get accounts
const accounts = await client.accounts.getAll();# 1. Find the transaction
monarch-money tx list --date 2026-01-15 --merchant "Target"
# 2. Get category ID
monarch-money cat list --show-ids
# 3. Update the transaction
monarch-money tx update <transaction_id> --category <category_id>monarch-money tx list --start-date 2026-01-01 --end-date 2026-01-31 --limit 100monarch-money acc list| Error | Solution |
|-------|----------|
| "Not logged in" | Run monarch-money auth login |
| "MFA code required" | Set MONARCH_MFA_SECRET environment variable |
| "Invalid credentials" | Verify email/password work at app.monarchmoney.com |
| "Session expired" | Run monarch-money auth login again |
Sessions are cached locally at ~/.mm/session.json. After initial login, subsequent commands reuse the saved session for faster execution.
To clear the session: monarch-money auth logout
Generated Mar 1, 2026
Individuals can automate transaction categorization and budget tracking by using the CLI to search for recent transactions and update categories based on spending patterns. This helps users maintain accurate financial records without manual entry, saving time and reducing errors.
Small business owners can use the skill to monitor transactions, categorize expenses by vendor or project, and generate reports for tax preparation. By automating updates and searches, it streamlines bookkeeping and ensures compliance with financial tracking requirements.
Financial advisors can integrate the TypeScript library into custom tools to analyze client spending, suggest budget adjustments, and provide personalized recommendations. This enables scalable, automated insights for multiple clients, enhancing service efficiency.
Freelancers can track income and expenses by searching transactions by date or merchant, updating categories for tax deductions, and monitoring account balances. This automates financial organization, helping freelancers stay on top of cash flow and reporting needs.
Offer a premium version of the CLI or library with advanced features like automated budget alerts, detailed analytics, and integration with other financial platforms. Revenue is generated through monthly or annual subscriptions from users seeking enhanced automation.
Provide consulting services to businesses for custom integrations of the TypeScript library into their existing financial systems. Revenue comes from project-based fees for setup, training, and ongoing support tailored to specific workflow needs.
Release the core CLI as open-source or freeware to attract users, then monetize through paid add-ons such as advanced reporting, multi-user support, or priority customer service. This model builds a user base while generating revenue from power users.
💬 Integration Tip
Ensure environment variables are securely stored and session caching is managed to avoid authentication issues; consider using the TypeScript library for custom automation scripts to extend functionality beyond CLI commands.
Query Copilot Money personal finance data (accounts, transactions, net worth, holdings, asset allocation) and refresh bank connections. Use when the user asks about finances, account balances, recent transactions, net worth, investment allocation, or wants to sync/refresh bank data.
Stripe API integration with managed OAuth. Manage customers, subscriptions, invoices, products, prices, and payments. Use this skill when users want to process payments, manage billing, or handle subscriptions with Stripe. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
QuickBooks API integration with managed OAuth. Manage customers, invoices, payments, bills, and run financial reports. Use this skill when users want to interact with QuickBooks accounting data. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Advanced financial calculator with future value tables, present value, discount calculations, markup pricing, and compound interest. Use when calculating investment growth, pricing strategies, loan values, discounts, or comparing financial scenarios across different rates and time periods. Includes both CLI and interactive web UI.
Track expenses via natural language, get spending summaries, set budgets
Query and manage personal finances via the official Actual Budget Node.js API. Use for budget queries, transaction imports/exports, account management, categorization, rules, schedules, and bank sync with self-hosted Actual Budget instances.