ynab-mcp

[1 API call] Get the authenticated user's information including user ID

[1 API call] List all budgets the user has access to, with optional account info

[1 API call] Get a single budget's full detail including all entities. Use 'last-used' for the most recently accessed budget.

[1 API call] Get a budget's date and currency format settings

[1 API call] List all accounts for a budget including balances and types

[1 API call] Get details for a single account

[1 API call] Create a new account in a budget

[1 API call] List all categories grouped by category group for a budget

[1 API call] Get details for a single category

[1 API call] Create a new category in a budget

[1 API call] Update an existing category's name, note, or goal

[1 API call] Get a category's budget details for a specific month

[1 API call] Update the budgeted/assigned amount for a category in a specific month. This is how you allocate money to categories.

[1 API call] Create a new category group in a budget

[1 API call] Update a category group's name

[1 API call] List all payees for a budget

[1 API call] Get details for a single payee

[1 API call] Update a payee's name

[1 API call] List all payee GPS locations for a budget

[1 API call] Get a single payee location by ID

[1 API call] Get all GPS locations for a specific payee

[1 API call] List all budget months for a budget, showing income, budgeted, activity, and ready to assign

[1 API call] Get detailed info for a single budget month including all category balances. Use 'current' for the current month.

[1 API call] List all money movements for a budget (funds moved between categories)

[1 API call] Get money movements for a specific month

[1 API call] List all money movement groups for a budget

[1 API call] Get money movement groups for a specific month

[1 API call] List transactions for a budget with optional filters. Returns most recent transactions first.

[1 API call] Get details for a single transaction

[1 API call] Create a new transaction. Amounts are in dollars (positive for inflows, negative for outflows). For split transactions, set category_id to null and provide subtransactions.

[1 API call, bulk] Create multiple transactions at once. Each transaction needs account_id, date, and amount at minimum.

[1 API call] Update an existing transaction

[1 API call, bulk] Update multiple transactions at once. Each must include either id or import_id to identify the transaction.

[1 API call] Delete a transaction

[1 API call] Trigger an import of transactions from linked financial institutions

[1 API call] List transactions for a specific account

[1 API call] List transactions for a specific category

[1 API call] List transactions for a specific payee

[1 API call] List transactions for a specific month

[1 API call] List all scheduled (recurring) transactions for a budget

[1 API call] Get details for a single scheduled transaction

[1 API call] Create a new scheduled (recurring) transaction. Date must be in the future (up to 5 years).

[1 API call] Update an existing scheduled transaction

[1 API call] Delete a scheduled transaction

[Variable API calls] [Workflow] Merges a source category into a target category: re-categorizes all transactions and moves all historical budgeted amounts. Dry run costs 4 + N calls (N = number of budget months). Execution costs additional 1 + 2*M calls (M = months with non-zero budgets). Defaults to dry_run=true to preview changes before executing. After merging, the source category will have zero transactions and zero budgeted amounts across all months - you can then manually hide/delete it in the YNAB app.

[Variable API calls] [Workflow] Audits credit card payment categories by comparing each card's month-end balance against the payment category's available balance. Recommends exact budgeted amount corrections, accounting for cascading effects across months. Audit costs 3 + C + M API calls (C = credit cards, M = months). Set apply=true to automatically fix mismatches (adds 1 API call per mismatch).

[0 API calls] Check current YNAB API usage against the 200 calls/hour rate limit. Use this before batch operations to ensure you have enough budget.