Skip to main content
Glama
YNAB MCP Server

YNAB MCP Server

YNAB MCP Server

Latest release License: MIT ScottyOmega/Beacon 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

list_budgets

Lists all budgets on the account

list_accounts

Lists open accounts and balances in a budget

list_all_account_balances

Account balances across every budget

list_categories

Category groups/categories with balances

create_category_group

Creates a new category group

create_category

Creates a new category in an existing group

get_ready_to_assign

Current "Ready to Assign" amount

get_category_targets

Lists categories with a target (goal) set, and progress toward it

set_category_target

Sets, updates, or clears a target (goal) on a category

get_month_summary

Income/budgeted/spent/age-of-money snapshot

list_overspent_categories

Categories that went negative this month

spending_by_category

Total spend per category over a date range

spending_trend

Month-by-month spending trend, overall or for one category

net_worth_snapshot

Total balance across every account in every budget

top_payees

Total spend grouped by payee over a date range

largest_transactions

Biggest purchases in a date range

detect_recurring_charges

Flags payees that bill a consistent recurring amount (e.g. subscriptions)

budget_health_check

One-glance digest: Ready to Assign, age of money, overspent categories, uncategorized/unapproved counts

move_money_between_categories

Moves budgeted money from one category to another

list_uncategorized_transactions

Transactions with no category yet

list_unapproved_transactions

Transactions awaiting approval

approve_transaction

Marks a transaction approved

set_transaction_memo

Sets, replaces, or clears the memo on a transaction

search_transactions

Filter by payee, category (also matches split portions), account, date range

get_transaction

Full details of one transaction by ID, including the breakdown of a split

suggest_category

Suggests a category for one transaction, based on payee history and amount

bulk_suggest_categories

Runs suggest_category across every uncategorized transaction

categorize_transaction

Assigns a category to a transaction

split_transaction

Splits a transaction across multiple categories/amounts

Related MCP server: monarch-mcp

Requirements

Installing (as a user)

  1. Download ynab-mcp.mcpb from the latest release, or build it yourself (see below).

  2. Double-click the .mcpb file — Claude Desktop will prompt you to install it.

  3. 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.

  4. 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.mcpb

Then install the resulting ynab-mcp.mcpb as described above.

Security notes

  • Your YNAB token is never stored in this repository or bundled into the .mcpb package. 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.com using 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 tools
approve_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

    B3.4/5.0

    Scored across 30 tools

    Disambiguation4/5

    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.

    Naming Consistency3/5

    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.

    Tool Count3/5

    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.

    Completeness3/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      4
      MIT
    • F
      license
      B
      quality
      D
      maintenance
      MCP server that bridges Claude to Monarch Money for personal-finance analysis and lightweight edits.
      18
      -
    • F
      license
      B
      quality
      D
      maintenance
      A personal MCP server that gives Claude native access to YNAB budget data.
      46
      1
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables Claude to interact with YNAB budgets, including listing budgets, accounts, transactions, and category spending.
      4
      -