# Ynab Mcpb

> Ynab Mcpb is an open-source MCP server for finance and payments. Local YNAB server that previews every write, splits receipts and reconciles bank CSVs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Repository:** https://github.com/dizzlkheinz/ynab-mcpb
- **MCP Registry name:** io.github.dizzlkheinz/ynab-mcpb
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

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

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Crypto Fng](https://ai-powered.com/mcp/crypto-fng): Crypto Fng is a freemium MCP server for finance and payments.
- [Creditcard](https://ai-powered.com/mcp/creditcard): Creditcard is a freemium MCP server for finance and payments.
- [Zovo LEI Lookup](https://ai-powered.com/mcp/zovo-lei-lookup): Zovo LEI Lookup is an MCP server for finance and payments.
- [Recurly](https://ai-powered.com/mcp/recurly): Recurly is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/ynab-mcpb
