allocate_upcoming_paycheck
ChatGPTCalculate a draft allocation of available cash to supplied bills, essentials, debt minimums and reserves before the next payday. Returns an estimated daily spending amount and any shortfall. Does not pay bills or save changes.
calculate_debt_payoff
ChatGPTEstimate a USD debt payoff schedule using snowball or avalanche, supplied balances, APRs and fixed monthly minimums. Uses monthly interest, no fees or new charges; reports when payoff is not reached. Does not retrieve accounts or execute payments.
compare_payoff_scenarios
ChatGPTCompare snowball and avalanche estimates for up to five extra monthly payment amounts using supplied USD debts. Shows interest and payoff months under fixed APR and minimum-payment assumptions. No account access or payments.
create_category
ChatGPTCreate a new budget category under a top-level group.
create_expense
ChatGPTRecord an expense against a category.
create_paycheck_budget
ChatGPTCalculate an unsaved USD budget draft from supplied paydays and dated outflows. Assign bills to the latest preceding paycheck and identify funding gaps. Does not access or save a MyGood account.
create_split_expense
ChatGPTRecord ONE payment that covers several categories, e.g. a $380 church donation that is $300 tithing and $80 fast offering. Each category gets its own share; the shares add up to the total paid. list_expenses shows the parts as separate rows with the same split_id.
delete_expense
ChatGPTDelete an expense permanently.
delete_payment
ChatGPTDelete a received paycheck / income record permanently.
dismiss_bank_transaction
ChatGPTDismiss a bank transaction so it no longer shows up for review (does not delete anything else).
forecast_cash_flow
ChatGPTCalculate dated USD cash balances and the first potential shortfall from supplied income, bills and starting cash, over at most 366 days. Include all expected essentials and debt payments. No account access or changes.
get_budget_summary
ChatGPTGet the money picture for a month: total income, total spent, per-paycheck remaining (with a per-category breakdown of budgeted vs spent), safe-to-spend (amount left this pay period + per-day), and upcoming bills with due dates. Use this to answer questions like "how much can I spend", "how much is left by paycheck", or "what will I have left on the 30th".
get_me
ChatGPTGet the signed-in MyGood user and their budget id.
get_reconcile_status
ChatGPTGet the checking reconciliation state: the previous (baseline) balance and date, whether it is the first reconcile, and the uncleared expenses/payments (each with a "suggested" cleared default and a "matched" flag for bank-synced ones). Use before reconcile_account to see what will clear.
import_bank_transaction
ChatGPTCreate a NEW entry from a bank transaction: an expense (category_id required) or a received paycheck. Marks the transaction reviewed.
list_bank_accounts
ChatGPTList connected bank accounts. Set include_balances to also fetch each account's live current/available balance from the bank — use that balance to reconcile the checking account.
list_bank_transactions
ChatGPTList unreviewed bank transactions (positive amount = spending, negative = income). Each can then be matched to an existing entry (match_bank_transaction), imported as a new one (import_bank_transaction), or dismissed (dismiss_bank_transaction).
list_categories
ChatGPTList the user's budget categories with their group, monthly budget, payment day, and rollover flag.
list_expenses
ChatGPTList the user's expenses, optionally filtered by date range (from/to, YYYY-MM-DD) and/or category id. Use to answer "what did I spend on X" or "show my expenses in June".
list_payments
ChatGPTList received paychecks / income deposits, optionally filtered by date range (from/to, YYYY-MM-DD).
match_bank_transaction
ChatGPTLink a bank transaction to an EXISTING expense or received paycheck (marks the transaction reviewed and records the bank reference). Use when the user already logged the item manually.
reconcile_account
ChatGPTReconcile checking to the real bank balance (checkbook style). By default clears every suggested (already-cleared) transaction; pass explicit cleared_expense_ids/cleared_payment_ids to control it. On the FIRST reconcile it just sets the starting balance. Otherwise it commits only when baseline + cleared income − cleared expenses == balance; if it does not, nothing is written and the difference is returned (a missing/duplicate/wrong-amount transaction) — resolve it or pass adjust:true to post a balancing adjustment entry.
record_payment
ChatGPTRecord a received paycheck / income deposit. paycheck_id ties it to a scheduled paycheck (0 = extra/one-off income).
set_paycheck_budget
ChatGPTSet the budgeted amount for a category for one specific paycheck date.
set_transaction_reconciled
ChatGPTManually flag one expense or payment as reconciled (cleared) or not — e.g. mark a still-pending expense as uncleared.
split_expense
ChatGPTSplit an existing expense across several categories, or change how a split expense is divided. Give every part: they replace the current ones. One part turns it back into a plain expense. For a bank transaction, import it first (import_bank_transaction, any one of the categories), then split the new expense; the parts must add up to the bank amount.
sync_bank_transactions
ChatGPTPull the latest transactions from the connected bank(s) via Plaid. Returns counts of new/updated/removed transactions and how many are now awaiting review. Run this before list_bank_transactions to get fresh data.
update_category
ChatGPTUpdate an existing category's monthly budget, payment day, or rollover flag.
update_expense
ChatGPTUpdate an expense (date, amount, payee, category, or paycheck date).
update_payment
ChatGPTUpdate a received paycheck (date received, pay-period date, amount, payor, or scheduled paycheck id).