YNAB MCP Server
Connects Claude to YNAB so you can inspect budgets, accounts, categories, and transactions; make budget/transaction changes; and generate spending insights.
Confirm the server is connected with
hello.List budgets, accounts, balances, category groups/categories, Ready to Assign, category targets, monthly summaries, and overspent categories.
Search/get transactions; list uncategorized or unapproved transactions; approve transactions; set or clear memos.
Suggest categories from payee history for one transaction or all uncategorized transactions; categorize and split transactions.
Move money between categories; create category groups/categories; set, update, or clear category targets.
Run reports: spending by category, spending trends, net worth snapshot, top payees, largest transactions, recurring charge detection, and budget health check.
Data-changing tools run only when Claude explicitly calls them; the YNAB token is stored by Claude Desktop and used only against api.ynab.com.
YNAB MCP Server
A custom MCP server that connects Claude to YNAB (You Need A Budget). It lets Claude view your budgets, accounts, and categories; search and categorize transactions; suggest categories based on payee history; split transactions; move money between categories; set category targets; and pull spending reports — all through conversation.
Built as a Claude Desktop Extension (.mcpb), which packages the server so it can be installed with a couple of clicks.
Tools
Tool | What it does |
| Lists all budgets on the account |
| Lists open accounts and balances in a budget |
| Account balances across every budget |
| Category groups/categories with balances |
| Creates a new category group |
| Creates a new category in an existing group |
| Current "Ready to Assign" amount |
| Lists categories with a target (goal) set, and progress toward it |
| Sets, updates, or clears a target (goal) on a category |
| Income/budgeted/spent/age-of-money snapshot |
| Categories that went negative this month |
| Total spend per category over a date range |
| Month-by-month spending trend, overall or for one category |
| Total balance across every account in every budget |
| Total spend grouped by payee over a date range |
| Biggest purchases in a date range |
| Flags payees that bill a consistent recurring amount (e.g. subscriptions) |
| One-glance digest: Ready to Assign, age of money, overspent categories, uncategorized/unapproved counts |
| Moves budgeted money from one category to another |
| Transactions with no category yet |
| Transactions awaiting approval |
| Marks a transaction approved |
| Sets, replaces, or clears the memo on a transaction |
| Filter by payee, category (also matches split portions), account, date range |
| Full details of one transaction by ID, including the breakdown of a split |
| Suggests a category for one transaction, based on payee history and amount |
| Runs |
| Assigns a category to a transaction |
| Splits a transaction across multiple categories/amounts |
Related MCP server: monarch-mcp
Requirements
Claude Desktop (macOS, Windows, or Linux)
Node.js 18 or later
A YNAB account and a Personal Access Token (generate one in YNAB under Account Settings → Developer Settings → New Token)
Installing (as a user)
Download
ynab-mcp.mcpbfrom the latest release, or build it yourself (see below).Double-click the
.mcpbfile — Claude Desktop will prompt you to install it.In Claude's extension settings for YNAB, paste your Personal Access Token into the field provided. It's stored by Claude Desktop itself, not in this repo or the package.
Start a new chat and try: "list my YNAB budgets."
Building from source
git clone <this-repo-url>
cd ynab-mcp
npm install
npx @anthropic-ai/mcpb pack . ynab-mcp.mcpbThen install the resulting ynab-mcp.mcpb as described above.
Security notes
Your YNAB token is never stored in this repository or bundled into the
.mcpbpackage. It's collected by Claude Desktop's own extension settings UI (a masked field) and injected as an environment variable (YNAB_ACCESS_TOKEN) when the server runs.The server only talks to
api.ynab.comusing that token; nothing else.Tools that change data (
categorize_transaction,split_transaction,approve_transaction,move_money_between_categories,create_category,create_category_group,set_category_target,set_transaction_memo) only run when Claude explicitly calls them — nothing runs automatically in the background.
License
MIT
Available Tools
30 toolsapprove_transactionA
Marks a transaction as approved. Look up transaction_id with list_unapproved_transactions first.
Inputs: transaction_id (required), budget_id.
budget_health_checkA
A single at-a-glance digest of budget health: Ready to Assign, age of money, any overspent categories, and counts of uncategorized/unapproved transactions — instead of checking each separately.
Inputs: budget_id.
bulk_suggest_categoriesA
Suggests categories for every uncategorized transaction in a budget at once, using each payee's categorization history. Returns a review list — nothing is applied automatically, use categorize_transaction to apply a suggestion you approve of.
Inputs: budget_id.
categorize_transactionB
Assigns a category to a specific transaction. Look up category_id with list_categories and transaction_id with list_uncategorized_transactions first.
Inputs: category_id (required), transaction_id (required), budget_id.
create_categoryA
Creates a new category within an existing category group. Use list_categories first to find the category_group_name, or create one with create_category_group.
Inputs: name (required), category_group_name (required), budget_id.
create_category_groupB
Creates a new category group (a section that categories live under) in a budget.
Inputs: name (required), budget_id.
detect_recurring_chargesA
Flags payees that appear to bill a consistent amount repeatedly over the last several months — useful for spotting subscriptions, including ones you may have forgotten about. Heuristic: amounts from the same payee that stay within 5% of their average, occurring at least min_occurrences times.
Inputs: budget_id, lookback_months, min_occurrences.
get_category_targetsA
Lists categories that have a target (goal) set, with the target amount, type, due date if any, and progress. Categories without a target are omitted.
Inputs: budget_id.
get_month_summaryB
Gets a financial snapshot for a budget month: income, total budgeted, total spent, money left to assign, and age of money.
Inputs: month, budget_id.
get_ready_to_assignA
Gets the current 'Ready to Assign' amount for a budget — the money not yet assigned to any category this month.
Inputs: budget_id.
get_transactionA
Gets the full details of one transaction by ID: date, payee, category, account, amount, memo, approved/cleared status, and flag. Split transactions include a 'splits' array showing each portion's category and amount. Find transaction IDs with search_transactions or the list_* transaction tools.
Inputs: transaction_id (required), budget_id.
helloA
Says hello back, to confirm the YNAB MCP server is connected and working.
Inputs: name.
largest_transactionsA
Lists the biggest purchases (outflows) in a date range (defaults to the current month so far) — a quick gut-check on where money actually went. Excludes transfers between your own accounts.
Inputs: limit, budget_id, since_date, until_date.
list_accountsB
Lists the open accounts in a budget (checking, savings, credit cards, etc.) with their current balances.
Inputs: budget_id.
list_all_account_balancesA
Lists account balances across every budget on this account, grouped by budget. Useful for a full net-worth view without checking each budget individually.
Inputs: no named parameters.
list_budgetsA
Lists all YNAB budgets available to this account, with their IDs and names.
Inputs: no named parameters.
list_categoriesA
Lists the category groups and categories in a budget, with their IDs, names, and remaining balances. Use a category's id with categorize_transaction.
Inputs: budget_id.
list_overspent_categoriesA
Lists categories with a negative balance this month — categories that have been overspent. Informational only; does not move any money.
Inputs: budget_id.
list_unapproved_transactionsA
Lists transactions that haven't been approved yet (typically bank-imported transactions awaiting review). This is separate from categorization — a transaction can be categorized but still unapproved. Split transactions include a 'splits' array showing each portion's category and amount.
Inputs: budget_id.
list_uncategorized_transactionsA
Lists transactions that don't yet have a category assigned, so they can be reviewed and categorized. Split transactions include a 'splits' array showing each portion's category and amount.
Inputs: budget_id.
move_money_between_categoriesA
Moves budgeted money from one category to another within the same month — e.g. moving $50 from Child Support into Haircuts to cover a specific expense. Reduces the source category's assigned amount and increases the destination's by the same amount. Look up category_id values with list_categories first.
Inputs: amount (required), to_category_id (required), from_category_id (required), month, +1 more.
net_worth_snapshotA
Totals your current balance across every open account in every budget, into a single net worth figure, plus a per-budget breakdown.
Inputs: no named parameters.
search_transactionsA
Searches transactions in a budget by payee, category, account, and/or date range. All filters are optional and combine together. The category filter also matches the portions of split transactions: a split that matches is returned as its parent transaction with the matching portions flagged "matched": true. Split transactions include a 'splits' array showing each portion's category and amount.
Inputs: limit, budget_id, payee_name, since_date, +3 more.
set_category_targetA
Sets, updates, or clears a target (goal) on a category. Provide either goal_target_date (a one-time target due by a specific date) or goal_frequency (a recurring target), not both. Pass clear_target: true to remove an existing target instead.
Inputs: category_id (required), budget_id, goal_target, clear_target, +2 more.
set_transaction_memoA
Sets (replaces) the memo on a transaction. Pass an empty string to clear the memo. To keep an existing memo, look it up first with search_transactions and include it in the new text.
Inputs: memo (required), transaction_id (required), budget_id.
spending_by_categoryA
Reports total spending per category over a date range (defaults to the current month so far). Excludes transfers between your own accounts.
Inputs: budget_id, since_date, until_date.
spending_trendA
Shows how spending has changed month by month over a recent window — either overall or for one category. Useful for spotting whether spending in an area is creeping up or down over time.
Inputs: months, budget_id, category_name.
split_transactionA
Splits a single transaction across multiple categories with different amounts — e.g. a $75 haircut charge where $50 goes to your category and $25 goes to a category tracking money owed by someone else. Provide at least 2 splits; their amounts must add up to the transaction's total. This cannot be undone via this tool and does not work on transactions that are already split.
Inputs: splits (required), transaction_id (required), budget_id.
suggest_categoryA
Suggests which category a transaction likely belongs to, based on how past transactions from the same payee were categorized. Especially useful when one payee covers multiple different charges (e.g. two different bills from the same company) that can be told apart by amount.
Inputs: amount (required), payee_name (required), budget_id.
top_payeesA
Reports total spending grouped by payee over a date range (defaults to the current month so far) — who you spend the most money with. Excludes transfers between your own accounts.
Inputs: limit, budget_id, since_date, until_date.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 30 tools
Most tools target a clearly distinct resource+action (list_uncategorized_transactions vs list_unapproved_transactions vs search_transactions vs get_transaction), and descriptions explicitly state how they differ. A few pairs blur boundaries — net_worth_snapshot vs list_all_account_balances, budget_health_check vs get_month_summary/list_overspent_categories — but these are aggregations of other tools and are described well enough to disambiguate.
Core CRUD tools follow a clean verb_noun snake_case pattern (list_budgets, get_transaction, create_category, categorize_transaction). However, roughly a third of the surface uses noun phrases with no verb (spending_by_category, net_worth_snapshot, top_payees, largest_transactions, budget_health_check), and bulk_suggest_categories inserts a prefix mid-pattern. Readable, but two competing conventions.
Thirty tools is heavy and exceeds a comfortable working set, though the YNAB domain (budgets, accounts, transactions, categories, targets, analytics) genuinely spans a lot of ground. A handful of analytics tools (net_worth_snapshot, budget_health_check, list_all_account_balances) duplicate coverage already provided by other tools, so the set could be trimmed.
Transaction review, categorization, splitting, memo, approvals, categories/groups, targets, budgeting moves, and rich analytics are all covered. But basic transaction lifecycle is missing: there is no create_transaction, no delete, and no way to change a transaction's amount, date, or payee — only memo/category — nor any delete for categories, which will block common agent tasks.
Maintenance
Related MCP Connectors
Personal finance for AI agents — onboard, import statements, categorize & budget over MCP.
Log, query, and edit expenses, budgets, and accounts in Manilo from any MCP-compatible AI assistant.
Hosted remote MCP server for YNAB on Cloudflare Workers with OAuth
Ask Claude about your income and spending, and import bank statements. No bank login.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server for interacting with YNAB (You Need A Budget). Provides tools for accessing budget data through MCP-enabled clients like Claude Desktop.4MIT
- FlicenseBqualityDmaintenanceMCP server that bridges Claude to Monarch Money for personal-finance analysis and lightweight edits.18-
- FlicenseBqualityDmaintenanceA personal MCP server that gives Claude native access to YNAB budget data.461-
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables Claude to interact with YNAB budgets, including listing budgets, accounts, transactions, and category spending.4-