MCP Server for YNAB
io.github.hs737/mcp-server-for-ynab·v0.4.0·2 starsConnect your AI assistant to YNAB. Read-only by default, with reversible opt-in writes.
2 stars82 downloads/wk
Reviews
Write oneNobody has reviewed MCP Server for YNAB yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
MCP Server for YNAB tools (63, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
accounts_getaccounts_listanalysis_assignment_patternsanalysis_copied_forward_monthsanalysis_credit_fundinganalysis_flow_traceanalysis_group_parityanalysis_overspent_categoriesanalysis_overspent_historyanalysis_recurring_chargesanalysis_target_funding_gapsanalysis_unassigned_transfersanalysis_upcoming_scheduled_risksbookkeeping_categorization_suggestionsbookkeeping_memo_annotation_suggestionsbookkeeping_transaction_historycategories_get[READ] Get a single category by ID. Amounts are in milliunits (1000 = $1.00).
categories_get_for_monthcategories_listcategory_groups_summary_by_monthchanges_sincehistory_listhistory_showmoney_movement_groups_listmoney_movement_groups_list_by_monthmoney_movements_listmoney_movements_list_by_monthmonths_getmonths_listmonths_rangeoverview_available_toolsoverview_balance_identityoverview_budget_snapshotoverview_cash_positionoverview_month_healthoverview_request_budgetpayee_locations_getpayee_locations_listpayee_locations_list_for_payeepayees_get[READ] Get a single payee by ID.
payees_listpingplans_getplans_get_settingsplans_list[READ] List all YNAB plans (budgets) available to the authenticated user.
reconcile_previewscheduled_transactions_getscheduled_transactions_listtransactions_gettransactions_listtransactions_list_by_accounttransactions_list_by_categorytransactions_list_by_monthtransactions_list_by_payeetransactions_match_statementtriage_pending_importstriage_reconciliationtriage_summarytriage_unapprovedtriage_uncategorizedtriage_unmatched_manualuser_get[READ] Get the authenticated YNAB user. Returns the user ID.
write_toolwrite actionRegister a write tool, or skip registration when writes are disabled.
Public scan report
scanner v0.1.10 · 2026-10-16 · same rubric, same numbers if you re-run it
- Code scan95 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 2 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How MCP Server for YNAB compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 65% of 48,243 servers
- Tools
- 63
- the typical server has 7
- Tools that change things
- 2%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 2
- more than 75% of 28,706 servers
- Downloads a week
- 82
- more than 57% of 12,306 servers with a package
What its tools let an agent do: 54 read · 4 create · 5 change
Install MCP Server for YNAB in Claude Code, Cursor or VS Code
claude mcp add mcp-server-for-ynab -- uvx mcp-server-for-ynab
What the publisher says
From the MCP Server for YNAB repository's README, as published. We do not edit it. Read it on GitHub
<!-- mcp-name: io.github.hs737/mcp-server-for-ynab -->
MCP Server for YNAB
Ask your budget a question. Connect Claude, Codex, Cursor, or any MCP client to YNAB and get answers about your actual money — how the month is going, what is overspent, what your subscriptions really cost.
<!-- Absolute URL on purpose: this README is also the package description on PyPI, where a repository-relative image path resolves to nothing. -->
YNAB_API_KEY=your_token uvx mcp-server-for-ynab smokeRead-only by default. The write tools are not registered at all unless you set YNABALLOWWRITES=1, so they never appear to the assistant and nothing can change your budget until you say so. When you do enable them, every write records the state that preceded it and can be undone.
An MCP server that exposes the YNAB API as tools, then adds enriched tools answering questions the raw API cannot answer in one call — budget health, cleanup queues, spending analysis, recurring charges.
Quick Start
1. Get a YNAB token
Generate a personal access token at app.ynab.com/settings/developer.
You also need uv, which provides uvx:
curl -LsSf https://astral.sh/uv/install.sh | sh # macOS and Linux
brew install uv # macOS with Homebrew
winget install --id=astral-sh.uv -e # WindowsCheck both work. Nothing to clone — uvx fetches the package and runs it in a throwaway environment:
YNAB_API_KEY=your_token uvx mcp-server-for-ynab smokesmoke validates configuration and tool registration, then exits. It should print smoke: app created, 62 tools registered.
2. Add it to your client
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
MCP Server for YNAB: common questions
- Is MCP Server for YNAB safe?
- Mostly: it is graded B (83/100). Read the MCP Server for YNAB safety report
- How do I install MCP Server for YNAB?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does MCP Server for YNAB need an API key?
- Yes. The registry entry asks for
YNAB_API_KEY. - Is MCP Server for YNAB maintained?
- The last commit was 22 days ago (2026-10-14). The latest release is v0.4.0.
- How does MCP Server for YNAB compare with other MCP servers?
- safety score 83/100 (higher than 65% of 48,243 servers); tools 63 (the typical server has 7); tools that change things 2% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.