MCP.Market

MCP Server for YNAB

by hs737·io.github.hs737/mcp-server-for-ynab·v0.4.0·2 stars

Connect your AI assistant to YNAB. Read-only by default, with reversible opt-in writes.

B83/100grade B
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

2 stars82 downloads/wk

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • accounts_get
  • accounts_list
  • analysis_assignment_patterns
  • analysis_copied_forward_months
  • analysis_credit_funding
  • analysis_flow_trace
  • analysis_group_parity
  • analysis_overspent_categories
  • analysis_overspent_history
  • analysis_recurring_charges
  • analysis_target_funding_gaps
  • analysis_unassigned_transfers
  • analysis_upcoming_scheduled_risks
  • bookkeeping_categorization_suggestions
  • bookkeeping_memo_annotation_suggestions
  • bookkeeping_transaction_history
  • categories_get

    [READ] Get a single category by ID. Amounts are in milliunits (1000 = $1.00).

  • categories_get_for_month
  • categories_list
  • category_groups_summary_by_month
  • changes_since
  • history_list
  • history_show
  • money_movement_groups_list
  • money_movement_groups_list_by_month
  • money_movements_list
  • money_movements_list_by_month
  • months_get
  • months_list
  • months_range
  • overview_available_tools
  • overview_balance_identity
  • overview_budget_snapshot
  • overview_cash_position
  • overview_month_health
  • overview_request_budget
  • payee_locations_get
  • payee_locations_list
  • payee_locations_list_for_payee
  • payees_get

    [READ] Get a single payee by ID.

  • payees_list
  • ping
  • plans_get
  • plans_get_settings
  • plans_list

    [READ] List all YNAB plans (budgets) available to the authenticated user.

  • reconcile_preview
  • scheduled_transactions_get
  • scheduled_transactions_list
  • transactions_get
  • transactions_list
  • transactions_list_by_account
  • transactions_list_by_category
  • transactions_list_by_month
  • transactions_list_by_payee
  • transactions_match_statement
  • triage_pending_imports
  • triage_reconciliation
  • triage_summary
  • triage_unapproved
  • triage_uncategorized
  • triage_unmatched_manual
  • user_get

    [READ] Get the authenticated YNAB user. Returns the user ID.

  • write_toolwrite action

    Register 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

no findings
  • 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
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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 smoke

Read-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               # Windows

Check 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 smoke

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