Pp Monarch Money

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/payments/monarch-money/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Monarch Money — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the monarch-money-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install monarch-money --cli-only

2. Verify: monarch-money-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

go install github.com/mvanhorn/printing-press-library/library/payments/monarch-money/cmd/monarch-money-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

When to Use This CLI

Use this CLI when the user asks about:

• Monarch Money account balances
• Monarch Money transaction tags
• recent or date-filtered Monarch transactions
• monthly or custom-period cashflow
• creating, updating, tagging, or deleting a specific Monarch transaction
• a specific read-only Monarch GraphQL query

Do not use it for rule changes, account refreshes, budgeting mutations, or broad remote writes. Transaction writes are available only through explicit first-class commands that dry-run by default and require --yes to apply.

Authentication

The CLI supports a saved session or an environment token. Prefer environment variables over putting secrets directly in shell history:

MONARCH_EMAIL='user@example.com' MONARCH_PASSWORD='...' monarch-money-pp-cli login

If MFA is required:

MONARCH_EMAIL='user@example.com' MONARCH_PASSWORD='...' monarch-money-pp-cli login --mfa 123456

Alternatively, set an existing token:

export MONARCH_TOKEN='...'

Then verify:

monarch-money-pp-cli doctor

Unique Capabilities

These capabilities aren't available in generic shell access to Monarch data.

• query — Run custom read-only GraphQL query files while refusing files that contain GraphQL mutations.

  Use when the built-in account, tag, transaction, and cashflow commands are too narrow but the workflow still needs a read-only guard.

monarch-money-pp-cli query query.graphql --operation OperationName --variables '{"limit":10}'

• Transaction CRUD commands — Create, update, tag, and delete individual transactions through narrow mutation commands.

  Use these for transaction cleanup after the user has identified the intended transaction. Omit --yes first to inspect the dry-run payload.

monarch-money-pp-cli transactions update TRANSACTION_ID --notes 'Reviewed'
monarch-money-pp-cli transactions update TRANSACTION_ID --notes 'Reviewed' --yes

Best command mapping

• "Are we connected to Monarch?" → monarch-money-pp-cli status
• "Show account balances" → monarch-money-pp-cli accounts
• "What tags exist?" → monarch-money-pp-cli tags --limit 200
• "Recent transactions" → monarch-money-pp-cli transactions --days 30 --limit 50
• "Cashflow this month" → monarch-money-pp-cli cashflow
• "Cashflow in January" → monarch-money-pp-cli cashflow --start 2026-01-01 --end 2026-01-31
• "Update this transaction note" → monarch-money-pp-cli transactions update TRANSACTION_ID --notes 'NOTE', then rerun with --yes after review
• "Put these tags on this transaction" → monarch-money-pp-cli transactions set-tags TRANSACTION_ID --tag-id TAG_ID, then rerun with --yes after review
• "Need raw output for analysis" → add --json