Ynab Mcpb
Local YNAB server that previews every write, splits receipts and reconciles bank CSVs
- 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-mcpbAdd 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/developerRequiredYNAB_MCP_WRITE_MODEWrite policy: read-only, preview (default), or enabledYNAB_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.

