Budgets and reserves
Spending plans, tax and accountant costs, reserve accounts and funding gaps before filing.
8 actions
Give an AI assistant only these actions with the budgets MCP toolset.
https://app.getoatmilk.com/api/mcp?toolset=budgetsbudgets.accounts
- POST
budgets.accounts.designateDesignate a bank account for operating cash, GST/HST, income tax, accountant fees or another reserve, optionally capping the reserved amount. The account must belong to this company. Requires its purposeRevision as expectedRevision, or zero when no designation exists. Does not move funds, change a Wise account or make a payment. - GET
budgets.accounts.getRead one bank account's saved reserve designation and revision. Returns null when no designation exists in this company.
budgets
- POST
budgets.evaluateRefresh deterministic budget and filing funding checks, adding or resolving funding warnings in the existing Checklist. Existing reminder settings control scheduled emails. Does not file returns, pay tax or move funds. Requires an idempotencyKey. - GET
budgets.getRead one saved spending budget by ID, including an inactive plan. Returns null when unavailable in this company. - GET
budgets.overviewRead spending budgets, reviewed actuals, upcoming tax and accountant obligations, reserve coverage, and future recurring purchase forecasts. Use sections to load only due, spending, reserves or recurring; omitted sections return empty arrays and recurringForecast null. No sections returns all. Recurring forecasts reuse reviewed charges, saved subscription status and accepted same-currency merges, with evidence, amount basis, uncertainty and per-currency totals. They are speculative future costs, kept separate from actual spend, tax liabilities and funding obligations. Reuses official compliance dates and reviewed GST/HST workpapers. Unknown tax amounts and stale or missing balances remain unknown; each reserve is counted once. - POST
budgets.saveCreate or edit a monthly, quarterly or yearly spending budget, for all expenses or one category. Actuals use ledger entries and splits, with refunds deducted and transfers excluded. Requires current expectedRevision or zero for a new budget and an idempotencyKey. Does not change bookkeeping entries.
budgets.obligations
- GET
budgets.obligations.getRead one saved payment plan by ID, including an inactive plan, or the current compliance funding plan by compliance:<item ID>. Returns null when unavailable in this company. - POST
budgets.obligations.saveCreate or edit a tax, GST/HST, accountant or other payment plan, keeping filing and payment dates separate and distinguishing an estimate from a confirmed amount. A negative amount is an expected refund and never offsets another obligation. Recording paidMinor is a planning note, not a bank payment or filed return. Link a complianceItemId to replace its automatic funding plan.