manage_scheduled_transaction
Create, read, update, or delete a scheduled transaction. Partial updates read fresh details and preserve omitted fields. Dates use UTC and must be in the next five years. The API does not create scheduled splits; this tool protects existing split parts by requiring a non-split record for updates.
get_budget
Retrieve detailed information about a specific budget, including date/currency format, summary, and provider budget records for delta merging. Use "last-used" or "default" as shortcuts for the budget ID.
update_payee
Rename an existing payee.
list_budgets
Retrieve all budgets belonging to the authenticated YNAB user. Returns budget names, IDs, date ranges, and format settings. Use the returned budget IDs for other YNAB operations.
list_scheduled_transactions
Retrieve all scheduled (recurring) transactions in a budget. Includes frequency, next occurrence date, and transaction details.
list_transactions
Retrieve transactions from a budget with flexible filtering. Filter by account, category, payee, month, date, or type (uncategorized/unapproved). Amounts are in milliunits (e.g., -10000 = -$10.00 outflow).
create_account
Create a new financial account in a budget. Specify the account name, type, and starting balance. The balance is in milliunits (e.g., $100.00 = 100000).
list_payees
Retrieve all payees for a budget. Payees that represent account transfers include the linked account ID.
list_months
Retrieve all budget months with summary data including income, assigned, activity, "Ready to Assign", and Age of Money.
create_transaction
Create one or more transactions, including splits. Amounts are integer milliunits. Import IDs deduplicate within an account and may match existing transactions; returned IDs are saved records, not proof of new ownership.
list_categories
Retrieve all category groups and their categories for a budget. Includes budgeted amounts, activity, available balances, and goal information.
import_transactions
Trigger an import of transactions from all linked bank accounts in a budget. This is equivalent to clicking "Import" in the YNAB app. Only works for accounts that have direct import enabled.
get_month
Retrieve detailed budget data for a specific month, including income, total assigned, total activity, "Ready to Assign" amount, and per-category breakdowns. Use "current" for the current month.
update_transaction
Update supplied transaction fields, or convert a non-split transaction into a split. Existing split parts cannot be replaced. YNAB ignores changes to a split parent’s date, amount, or category; these changes are rejected.
delete_transaction
Delete a transaction by its ID. The transaction will be marked as deleted.
manage_category_group
Create or rename a category group. Groups organize categories in the budget.
get_transaction
Retrieve detailed information about a single transaction, including subtransactions (splits), transfer details, and import metadata.
list_accounts
List all financial accounts in a budget, including balances and account type. Accounts include checking, savings, credit cards, loans, and other asset/liability types.
manage_category
Create or update a category, or set its assigned amount for a month. Amounts are integer milliunits. Targets use supported target amount, date, cadence, and rollover fields; legacy goalType and goalDay writes are rejected because YNAB does not accept them.
get_current_user
Get the YNAB user ID associated with this connection.
create_payee
Create a payee in a budget. Payees are retained because the API does not provide payee deletion.