Get the id of the authenticated user for the configured access token.

List all budgets accessible to the configured YNAB access token.

Get an overview of one budget: metadata plus counts of accounts/categories/payees/transactions. For the actual account, category, or transaction data, use ynab_list_accounts / ynab_list_categories / ynab_list_transactions instead — this tool intentionally does not return the full embedded export (which can be very large for budgets with long history).

Get the date format and currency format settings for a budget.

List all accounts (checking, savings, credit card, etc.) in a budget, with balances in milliunits.

Get a single account by id, with balances in milliunits.

Create a new on-budget account. There is no API-supported way to close/delete an account afterwards — YNAB's public API has no update or close endpoint for accounts, only create and read, so this action can't be undone through this server (or any other API client).

List all category groups and categories in a budget, with budgeted/activity/balance figures (in milliunits) for the current month.

Get a single category by id, including budgeted/activity/balance and goal figures (in milliunits) for the current month.

Create a new category group in a budget.

Rename an existing category group.

Create a new category within an existing category group.

Update a category's name, note, and/or which category group it belongs to. Only the fields provided are changed. To change the budgeted (assigned) amount for a specific month, use ynab_assign_budgeted_amount instead.

Set the budgeted (assigned) amount for a category in a specific month — the "assign money" action. Amount is in milliunits and replaces the existing budgeted amount for that month, it does not add to it.

List summary figures (income/budgeted/activity/to_be_budgeted, in milliunits) for every month in a budget's history.

Get summary figures for one budget month plus every category's budgeted/activity/balance for that month (all in milliunits).

List all payees in a budget.

Get a single payee by id.

Create a new payee in a budget.

Rename an existing payee.

List all upcoming scheduled (future-dated, recurring) transactions in a budget.

List transactions in a budget. Defaults to the last 30 days if since_date is not given, and returns at most 200 transactions per call (most recent first) with has_more indicating whether more exist for the window. Note: the YNAB API has no result-count limit of its own, so this tool always fetches every transaction in the requested date range before applying the 200-result cap — narrow the date range for large or long-lived budgets rather than requesting everything at once, both to keep the response small and to avoid burning YNAB's 200-requests/hour rate limit on an oversized fetch. For repeated polling of the same budget, prefer last_knowledge_of_server over re-fetching the full date range each time.

Summarize spending (outflow) and income (inflow) per category over a date range, computed client-side from transactions (YNAB has no single endpoint for this). Defaults to the last 30 days if since_date is not given. Narrow the date range for large or long-lived budgets, both to keep the response small and to avoid burning YNAB's 200-requests/hour rate limit.

Create a single transaction. Amount is in milliunits: negative = outflow (spending), positive = inflow.

Create multiple transactions in a single call. Amounts are in milliunits: negative = outflow (spending), positive = inflow.

Update a transaction's account, date, amount, payee, category, memo, cleared status, and/or approved status. Only the fields provided are changed — this single tool covers approving a transaction, categorizing it, editing its amount, etc.

Permanently delete a transaction. This cannot be undone via the API. Requires confirm: true.