YNAB for AI agents

Agents read YNAB at once. Changes and sends are held for a person's approval by default.

About YNAB

YNAB (You Need A Budget) is a budgeting tool helping users track expenses, plan finances, and gain control over spending to reduce debt

What an agent can do in YNAB

Every YNAB action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.

Runs at once (reads)

Looks things up in YNAB without asking first. 22 actions.

  • Get Account by IDTool to retrieve a single account resource. Use when you need details of a specific account by its ID after determining the budget.
  • Get Budget By IDRetrieve a complete budget export by ID, including all accounts, categories, payees, and transactions. Use this tool when you need comprehensive budget data. The response includes: - Budget metadata (
  • Get Budget MonthTool to retrieve a specific budget month. Use when you need detailed summary and category budgets for a given month after confirming the budget ID. Monetary amounts are returned in milliunits (divide
  • Get Budget SettingsTool to retrieve budget-level settings. Use when you need to fetch currency and date formatting preferences for a specific budget.
  • Get Category by IDRetrieve a single YNAB budget category by its ID. Use this to get detailed category information including budgeted amounts, activity, balance, and goal settings. Amounts are returned for the current b
  • Get Payee by IDTool to retrieve a single payee by its ID. Use when you need full details of a payee after confirming the budget and payee selection.
  • Get Scheduled Transaction by IDTool to retrieve a single scheduled transaction. Use when you need details of a specific scheduled transaction by its ID after confirming the budget.
  • Get Transaction by IDTool to retrieve a single transaction by its ID. Use when you need detailed information for a specific transaction after confirming the budget.
  • Get Authorized UserTool to retrieve the authorized user's information. Use after authentication to get current user details.
  • List AccountsRetrieves all accounts for a specified YNAB budget. Use this tool to: - Get a complete list of accounts (checking, savings, credit cards, loans, etc.) in a budget - Retrieve account IDs for use with o
  • List BudgetsRetrieves all budgets accessible to the authenticated YNAB user. Use this tool to: - Get a list of all budgets in the user's YNAB account - Retrieve budget IDs for use with other YNAB operations - Opt
  • List CategoriesTool to list all category groups and their categories for a budget. Use when you need the full set of budget categories or only those changed since last sync. Category names may include emojis or near
Show all 22
  • List payees in a budgetTool to list payees in a budget. Use when you need all payees or only those changed since a known server knowledge value.
  • List Scheduled TransactionsList all scheduled (recurring) transactions for a YNAB budget. Returns future-dated transactions that repeat on a schedule (e.g., rent, subscriptions, paychecks). Supports delta sync to fetch only cha
  • List TransactionsTool to list transactions in a budget. Use when you need all or delta-filtered transactions after confirming the budget. Omitting all filters returns the full transaction history, which may produce la
  • List Transactions by AccountTool to list transactions for a specific account. Use when you need all or delta-filtered transactions for a given account after confirming the budget and account ID.
  • Get Month Category By IDTool to retrieve a single category for a specific budget month. Use after selecting the budget and month when you need month-specific category details.
  • List Budget MonthsTool to list months for a budget with summary information. Use when you need an overview of all months or only changed months since a given knowledge value (delta requests).
  • List Payee LocationsRetrieves all GPS locations associated with payees in a budget. Payee locations are recorded when transactions are saved using the YNAB mobile apps, storing GPS coordinates to help pre-populate nearby
  • List Payee Locations by PayeeRetrieves all GPS locations associated with a specific payee in a budget. Payee locations are recorded when transactions are saved using the YNAB mobile apps, storing GPS coordinates to help pre-popul
  • List Transactions by CategoryTool to list transactions for a specific category (excludes pending). Use when you need completed transactions for a given category after obtaining budget_id and category_id. Response includes deleted
  • List Transactions by PayeeTool to list transactions for a specific payee in a budget. Use when you need to fetch all non-pending transactions for a payee after confirming budget and payee IDs.

Held for approval by default (changes and sends)

Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 5 actions.

  • Create a new account in a budgetTool to create a new account in a budget. Use when you need to add a manual (non-linked) account to a specific budget.
  • Create Scheduled TransactionCreates a scheduled (recurring) transaction in a YNAB budget. Use this to set up bills, recurring expenses, or income that repeats on a schedule. Requires an account_id (from YNAB_LIST_ACCOUNTS), a da
  • Delete Scheduled TransactionPermanently deletes a scheduled transaction from a YNAB budget. Use this when a recurring transaction is no longer needed. This action cannot be undone. Obtain the scheduled_transaction_id from list_s
  • Update PayeeTool to update a payee. Use when you need to rename an existing payee.
  • Update Scheduled TransactionUpdate an existing scheduled transaction in YNAB. Allows modifying the date, frequency, amount, payee, category, memo, or account of a scheduled transaction. Use YNAB_LIST_SCHEDULED_TRANSACTIONS first

Changes wait in Needs you

Changes and sends in YNAB are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.

How approvals work

YNAB questions

Can an agent change data in YNAB on its own?

Not by default. Changes and sends in YNAB are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.

What can an agent read in YNAB?

This connector lists 22 read actions. Reads run at once, without waiting for approval.

How does YNAB connect?

It connects with OAuth 2.0. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.

Bring YNAB to your agents.