workbench-ynab
Tax-aware YNAB budget review and approval-gated write-back for Claude Code. Bundles a vendored YNAB MCP for zero-config setup. Part of the claude-workbench marketplace.
Not in a marketplace yet, so it loads for one session with --plugin-dir.
Plugin workbench-ynab in mike-bronner/workbench-ynab. Commands read from the repo's manifest — 1 month ago.
This plugin runs code on your machine — its hooks fire automatically on events like tool use and it starts local MCP servers. The exact commands are listed below; read them before installing.
What it installs
Skills (3)
estimated-taxThe M6-4 quarterly estimated-tax tracker — a stateful, data-driven YTD estimate of what is owed on side-hustle (Schedule C) earnings, plus the record of estimated payments already made and the resulting remaining liability per quarter. Pulls YTD business income/expense from YNAB, computes Schedule C
ynab-monitorRun one proactive between-run monitoring pass — read the monitor state store, fetch fresh YNAB account balances, incremental transactions, and current-month categories through the vendored MCP, run the four alert detectors (overdrawn, large/unusual transaction, budget overrun, bill due), dispatch an
ynab-protocolSwap-ready protocol for calling the vendored YNAB MCP. Use whenever a workbench-ynab skill, the orchestrator, or pre-approval config needs a YNAB MCP tool name — never hard-code a tool name; resolve it from this protocol's single source of truth so an MCP swap stays a one-file edit.
Slash commands (13)
/workbench-ynab:setupConfigure the workbench-ynab plugin — verify prerequisites, store the YNAB token in the Keychain, collect config interactively, write config.json, pre-approve the read-only YNAB tools, prove the vendored MCP boots and lists budgets, and deploy the unified review and proactive-monitor scheduled tasks
/workbench-ynab:uninstallTear down every piece of system state /workbench-ynab:setup created — the scheduled tasks, the Keychain token, the settings.json pre-approvals, and (only if you say so) the plaintext data directory. Idempotent — safe to re-run after a partial teardown.
/workbench-ynab:ynab-annual-reviewRun the annual YNAB review ad-hoc — orchestrator plans first, then the annual tier-wrapper skill runs, forced to the annual tier only. Strictly read-only.
/workbench-ynab:ynab-applyThe human-in-the-loop approval gate for YNAB write-back. Loads the pending change-set the weekly review proposed, groups it into typed batches, dry-runs each batch through the apply executor and shows a before → after diff with rationale + risk, then runs the workbench three-options decision protoco
/workbench-ynab:ynab-migrateRetire the legacy hand-run YNAB setup — detect the old Claude Desktop connector and prototype scheduled tasks, migrate the token (post-rotation) and config into the plugin, and offer to remove the deprecated connector, tasks, and directories. Idempotent and order-enforced; safe to re-run.
/workbench-ynab:ynab-monitorRun a single proactive between-run YNAB monitoring pass on demand — reads the monitor state store, fetches fresh account balances, incremental transactions, and current-month categories through the vendored YNAB MCP, runs the four alert detectors (overdrawn, large/unusual transaction, budget overrun
/workbench-ynab:ynab-monthly-reviewRun the monthly YNAB review ad-hoc — orchestrator plans first, then the monthly tier-wrapper skill runs, forced to the monthly tier only. Strictly read-only.
/workbench-ynab:ynab-portfolioRun the cross-budget portfolio rollup — one consolidated report across every budget in your config - combined net worth, aggregate income vs spending, cross-budget Ready-to-Assign, a unified health score, and a single YTD tax picture across the business-tagged budgets. Strictly read-only. NOT tax ad
/workbench-ynab:ynab-prunePrune old generated YNAB review reports under the retention policy — reports are unencrypted plaintext financial records that otherwise accumulate unbounded. Previews by default (dry-run); deletes only after you approve, via bin/ynab-prune.sh --apply. Age threshold defaults to 30 days, overridable v
/workbench-ynab:ynab-quarterly-tax-reviewRun the quarterly estimated-tax YNAB review ad-hoc — orchestrator plans first, then the quarterly-tax tier-wrapper skill runs, forced to the quarterly-tax tier only. Strictly read-only. NOT tax advice.
/workbench-ynab:ynab-reviewUnified YNAB review entry point — the ONLY entry point the scheduled task uses. Dispatches the read-only ynab-orchestrator to plan today's review tiers, surfaces any warnings to the user, then runs each eligible tier's wrapper skill in plan order. Strictly read-only — this router never writes to YNA
/workbench-ynab:ynab-taxUpdate and show the quarterly estimated-tax tracker — pull YTD business income/expense from YNAB, compute the Schedule C net + SE tax + income-tax estimate from your tax profile, reconcile estimated payments already recorded in YNAB, persist the running YTD state, and print a per-quarter summary of
/workbench-ynab:ynab-weekly-reviewRun the weekly YNAB review ad-hoc — orchestrator plans first, then the weekly tier-wrapper skill runs, forced to the weekly tier only. Strictly read-only.
Subagents (1)
ynab-orchestratorRead-only planner that owns the review schedule — computes which review tiers (annual / quarterly-tax / monthly / weekly) are eligible from today's date, inspects YNAB state (budget, accounts, categories, transactions), and returns a structured financial-review plan — which analyses to run, which YN
MCP servers (1)
ynabruns: bash ${CLAUDE_PLUGIN_ROOT}/bin/launcher.sh
Hooks (2)
- SessionStart
bash "${CLAUDE_PLUGIN_ROOT}/hooks/session-warmup.sh"
- PostCompact
bash "${CLAUDE_PLUGIN_ROOT}/hooks/session-warmup.sh"
Maintain workbench-ynab?
This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.