Demo

_{Paste a receipt → itemized split transaction in seconds}

What you can do

| Workflow | Example prompt | |---|---| | Receipt split | "Create a split transaction for this receipt and allocate tax." | | Bank reconciliation | "Reconcile my checking account using this CSV." | | Spending analysis | "What did I spend on takeout this month?" | | Transaction creation | "Create a transaction: $42.18 at Trader Joe's yesterday." | | Month overview | "Show my budget summary for January." |

How it works

graph LR
    U(You) -->|Plain English| C[Claude Desktop<br/>or any MCP client]
    C -->|MCP protocol| S[YNAB MCP Server<br/>28 tools]
    S -->|YNAB API| Y[(Your Budget)]

    style S fill:#2563EB,color:#fff,stroke:#1d4ed8
    style Y fill:#16a34a,color:#fff,stroke:#15803d
    style C fill:#7c3aed,color:#fff,stroke:#6d28d9

Features

• Receipt itemization — Paste a receipt, get an itemized split transaction with tax allocation automatically distributed across line items.
• Bank reconciliation (beta) — Import a bank CSV, fuzzy-match against YNAB, detect missing or mismatched transactions, and apply bulk fixes.
• 28 YNAB tools — Full coverage of budgets, accounts, transactions, categories, payees, months, and utilities.
• Delta sync — Fetches only changed data since the last request, keeping things fast.
• Markdown or JSON — All read tools support response_format: human-readable markdown tables (default) or structured JSON.
• MCP-native — Structured outputs, annotations, completions API, and resource templates.

How reconciliation works

sequenceDiagram
    participant You
    participant Claude
    participant MCP as YNAB MCP Server
    participant YNAB

    You->>Claude: "Reconcile my checking<br/>with this CSV"
    Claude->>MCP: reconcile_account(csv_data)
    MCP->>YNAB: Fetch transactions
    YNAB-->>MCP: YNAB transactions
    MCP->>MCP: Parse CSV<br/>Fuzzy-match payees & dates<br/>Detect missing / mismatched
    MCP-->>Claude: Matches + recommendations
    Claude->>You: "Found 47 matches, 3 missing.<br/>Apply changes?"
    You->>Claude: "Yes"
    Claude->>MCP: Apply recommended changes
    MCP->>YNAB: Create / update transactions
    MCP-->>Claude: Done
    Claude->>You: "3 transactions created,<br/>account reconciled."

Setup (2 minutes)

1 — Get a YNAB token

1. Open YNAB Web App
2. Go to Account Settings → Developer Settings → New Token
3. Copy it (shown once only)

2 — Install

{
  "mcpServers": {
    "ynab": {
      "command": "npx",
      

... [View full README on GitHub](https://github.com/dizzlkheinz/ynab-mcpb#readme)