Skip to content
MCP server

Ynab Mcpb

Local YNAB server that previews every write, splits receipts and reconciles bank CSVs

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.33.0
Listing updated
today

Similar MCP servers

About Ynab Mcpb

Ynab Mcpb is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Beyond mirroring YNAB's API, this server adds workflows YNAB does not offer. Paste or photograph a receipt and it produces a single split transaction with items in categories and tax distributed to the cent. Give it a bank CSV and it matches payees fuzzily, tolerates date differences, shows what is missing or mismatched and applies only the fixes you approve.

Writes are previewed by default: the assistant sees exactly what will change and must repeat the same request with a short-lived, single-use token. Write mode can be set to read-only or enabled, and a core tool profile trims the tool list to save context. Up to 100 transactions can be created or updated at once.

It runs locally and talks only to the YNAB API; whatever a tool returns goes to your AI provider. YNAB allows 200 requests an hour per token. It needs Node.js 24 or newer and is licensed AGPL-3.0, independent of YNAB.

Install

Run in a terminal

claude mcp add ynab-mcpb --env YNAB_ACCESS_TOKEN='<YNAB_ACCESS_TOKEN>' -- npx -y @dizzlkheinz/ynab-mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ynab-mcpb": {
      "command": "npx",
      "args": [
        "-y",
        "@dizzlkheinz/ynab-mcpb"
      ],
      "env": {
        "YNAB_ACCESS_TOKEN": "<YNAB_ACCESS_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ynab-mcpb": {
      "command": "npx",
      "args": [
        "-y",
        "@dizzlkheinz/ynab-mcpb"
      ],
      "env": {
        "YNAB_ACCESS_TOKEN": "<YNAB_ACCESS_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "ynab-mcpb": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dizzlkheinz/ynab-mcpb"
      ],
      "env": {
        "YNAB_ACCESS_TOKEN": "<YNAB_ACCESS_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ynab-mcpb": {
      "command": "npx",
      "args": [
        "-y",
        "@dizzlkheinz/ynab-mcpb"
      ],
      "env": {
        "YNAB_ACCESS_TOKEN": "<YNAB_ACCESS_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ynab-mcpb": {
      "command": "npx",
      "args": [
        "-y",
        "@dizzlkheinz/ynab-mcpb"
      ],
      "env": {
        "YNAB_ACCESS_TOKEN": "<YNAB_ACCESS_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • YNAB_ACCESS_TOKENYNAB Personal Access Token from https://app.ynab.com/settings/developerRequired
  • YNAB_MCP_WRITE_MODEWrite policy: read-only, preview (default), or enabled
  • YNAB_MCP_TOOL_PROFILEStatic tool profile: core or full (default)

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

ynab_set_default_budget
Sets the default budget for later tool calls.
ynab_export_transactions
Exports transactions to a local file.

What it does

Receipt splitting
One split transaction with each item categorized and tax allocated exactly.
Bank reconciliation
Matches a CSV against YNAB and applies approved fixes.
Spending analysis
Totals by category or payee and period comparisons.
Bulk cleanup
Create or update up to 100 transactions at once.
Preview-first writes
Each write needs a single-use confirmation token.
35 YNAB tools
Budgets, accounts, transactions, categories, payees, months and scheduled items.

Good for

  • Split a grocery receipt across categories
  • Reconcile a checking account with a bank CSV
  • Compare takeout spending month over month
  • Categorize last week's uncategorized transactions

Pricing

Open source

AGPL-3.0; free to run with your own YNAB subscription.

Ynab Mcpb FAQ

What do I need?

A YNAB personal access token and Node.js 24 or newer.

Can it change my budget without asking?

By default no; writes need a preview token, and a read-only mode removes write tools.

Does data leave my machine?

The server talks only to the YNAB API; tool results go to your AI provider.

What is the rate limit?

YNAB allows 200 requests per hour per token.

Is Ynab Mcpb free?

Yes. Ynab Mcpb is open source, so you can use and self-host it for free.

How do I add Ynab Mcpb to Claude Code?

Run this command in your terminal: claude mcp add ynab-mcpb --env YNAB_ACCESS_TOKEN='<YNAB_ACCESS_TOKEN>' -- npx -y @dizzlkheinz/ynab-mcpb

What are the best alternatives to Ynab Mcpb?

The closest alternatives to Ynab Mcpb are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Crypto Feeds and Crypto Fng.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers