Ynab Mcpb

Name: Ynab Mcpb
Author: dizzlkheinz

โดย dizzlkheinzรุ่น 0.31.0i★ –iรันบนเครื่อง

ชื่อใน registryio.github.dizzlkheinz/ynab-mcpb

ติดตั้ง

ภาพรวม

คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)

Local-first YNAB MCP for reconciliation, receipt splitting, safe cleanup, and spending analysis

สามเสาของ PopNx MCP

สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน

เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
ผลตรวจเบื้องต้นของเราiผ่าน 1 จาก 1 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
การใช้งานiยังไม่ได้วัด★ –

ใช้ทำอะไรได้

ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry

การเชื่อมต่อ: รันบนเครื่อง
ช่องทาง (transport): stdio
หมวด: อื่น ๆ
ต้องใส่ค่าเหล่านี้: YNAB_ACCESS_TOKEN

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ก่อนติดตั้ง

ผลตรวจเบื้องต้น: ผ่าน 1 จาก 1 ข้อ
รันในเครื่องคุณด้วยสิทธิ์ของผู้ใช้คุณ (ไฟล์ อินเทอร์เน็ต แอปต่าง ๆ)
ค่าที่คุณต้องใส่เอง: YNAB_ACCESS_TOKEN, YNAB_MCP_WRITE_MODE, YNAB_MCP_TOOL_PROFILE

ค่าที่ติดป้ายความลับคือกุญแจของบัญชีคุณ อย่าส่งให้ใคร และอย่าวางในแชต

ต้องเตรียมก่อน

npmติดตั้ง Node.js (มีคำสั่ง npx) ในเครื่อง

คุณใช้แอปไหน

ClaudeClaude CodeCursorVS CodeChatGPT

เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”

เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json

{
  "mcpServers": {
    "ynab-mcpb": {
      "command": "npx",
      "args": [
        "-y",
        "@dizzlkheinz/ynab-mcpb"
      ],
      "env": {
        "YNAB_ACCESS_TOKEN": "ใส่ค่าของคุณ",
        "YNAB_MCP_WRITE_MODE": "ใส่ค่าของคุณ",
        "YNAB_MCP_TOOL_PROFILE": "ใส่ค่าของคุณ"
      }
    }
  }
}

พิมพ์คำสั่งนี้ใน Terminal

claude mcp add ynab-mcpb --env YNAB_ACCESS_TOKEN='ใส่ค่าของคุณ' --env YNAB_MCP_WRITE_MODE='ใส่ค่าของคุณ' --env YNAB_MCP_TOOL_PROFILE='ใส่ค่าของคุณ' -- npx -y @dizzlkheinz/ynab-mcpb

เติมค่าที่เว้นว่างไว้ก่อนรัน

เปิดใน Cursor

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json

{
  "mcpServers": {
    "ynab-mcpb": {
      "command": "npx",
      "args": [
        "-y",
        "@dizzlkheinz/ynab-mcpb"
      ],
      "env": {
        "YNAB_ACCESS_TOKEN": "ใส่ค่าของคุณ",
        "YNAB_MCP_WRITE_MODE": "ใส่ค่าของคุณ",
        "YNAB_MCP_TOOL_PROFILE": "ใส่ค่าของคุณ"
      }
    }
  }
}

เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง

เปิดใน VS Code

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .vscode/mcp.json ของโปรเจกต์

{
  "servers": {
    "ynab-mcpb": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dizzlkheinz/ynab-mcpb"
      ],
      "env": {
        "YNAB_ACCESS_TOKEN": "ใส่ค่าของคุณ",
        "YNAB_MCP_WRITE_MODE": "ใส่ค่าของคุณ",
        "YNAB_MCP_TOOL_PROFILE": "ใส่ค่าของคุณ"
      }
    }
  }
}

ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น

ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี

ค่าที่ต้องใส่เอง

YNAB_ACCESS_TOKEN ความลับ จำเป็น env
YNAB Personal Access Token from https://app.youneedabudget.com/settings/developer
YNAB_MCP_WRITE_MODE env
Write policy: read-only, preview (default), or enabled
YNAB_MCP_TOOL_PROFILE env
Static tool profile: core, read-only, or full (default)

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

ทำอะไรได้บ้าง

รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 8 พ.ย. 2569

✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub dizzlkheinz ซึ่งเป็นเจ้าของ repo
… ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
… ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
– ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
– ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
… ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต

เทียบกับตัวอื่นในหมวด อื่น ๆi

ดาวมากกว่า 0% ของอีก 18386 ตัวในหมวดนี้
ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 78% ของอีก 18386 ตัวในหมวดนี้
ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 18386 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

Ynab Mcpb ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

ต้องใส่ค่าเหล่านี้: YNAB_ACCESS_TOKEN

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.31.0) เข้า registry 11 วันที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Node.js ในเครื่องด้วย

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี Spec Driven Development, Remote Desktop Commander, Tethered Trust

ตัวที่ใช้แทนได้

server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว

อ่านการ์ด:★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

Spec Driven Development

โดย formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

รันบนเครื่อง★ 440MITอัปเดต 14 เดือนที่ผ่านมา

ติดตั้ง

Remote Desktop Commander

โดย desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

รันบนคลาวด์★ 211อัปเดต เมื่อวานซืน

ติดตั้ง

Tethered Trust

โดย tetheredtrust.com

Fit, compatibility and recall checks for AI agents before they buy: verdicts, evidence, receipts.

รันบนคลาวด์อัปเดต วันนี้

ติดตั้ง

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

YNAB MCP Server

Connect YNAB to any AI assistant. Manage your budget in plain English.

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?"
Scheduled cash flow	"What scheduled bills and income are due 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

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.
35 YNAB tools — Full coverage plus scheduled transactions and deterministic period analytics.
Write safety by default — Preview mode requires a short-lived, single-use confirmation bound to the exact validated request.
Smaller tool profiles — Choose core, read-only, or full at startup without dynamic registration.
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

Show workflow diagram

sequenceDiagram

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

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

Setup (2 minutes)

1 — Get a YNAB token

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

2 — Install

Claude Desktop — MCPB file (recommended)

Download the latest .mcpb from Releases
Drag it into Claude Desktop
Enter your YNAB_ACCESS_TOKEN when prompted
Restart Claude Desktop

Claude Desktop — npx

Add to your Claude Desktop config:

"mcpServers": { "ynab": { "command": "npx", "args": ["-y", "@dizzlkheinz/ynab-mcpb@latest"], "env": { "YNAB_ACCESS_TOKEN": "your-token-here" } } } }

Cline (VS Code)

"mcpServers": { "ynab": { "command": "npx", "args": ["-y", "@dizzlkheinz/ynab-mcpb@latest"], "env": { "YNAB_ACCESS_TOKEN": "your-token-here" } } } }

Codex

[mcp_servers.ynab-mcpb]

command = "npx" args = ["-y", "@dizzlkheinz/ynab-mcpb@latest"] env = {"YNAB_ACCESS_TOKEN" = "your-token-here"} startup_timeout_sec = 120

Any other MCP client

Command: npx
Args: ["-y", "@dizzlkheinz/ynab-mcpb@latest"]
Env: YNAB_ACCESS_TOKEN=

3 — Try these prompts

List my budgets and set the default to my main budget.

Show recent transactions in my checking account. How much did I spend on groceries in the last 30 days? Create a transaction: $42.18 at Trader Joe's yesterday.

Tools (35)

See all tools by category

Category	Tools
Budgets	`list_budgets` `get_budget` `get_default_budget` `set_default_budget`
Accounts	`list_accounts` `get_account` `create_account`
Transactions	`list_transactions` `get_transaction` `create_transaction` `create_transactions` `update_transaction` `update_transactions` `delete_transaction` `export_transactions` `compare_transactions` `create_receipt_split_transaction`
Categories	`list_categories` `get_category` `update_category`
Payees	`list_payees` `get_payee`
Months	`list_months` `get_month`
Reconciliation	`reconcile_account`
Scheduled transactions	`list_scheduled_transactions` `get_scheduled_transaction` `create_scheduled_transaction` `update_scheduled_transaction` `delete_scheduled_transaction`
Analytics	`analyze_spending` `compare_spending_periods`
Utilities	`get_user` `diagnostic_info` `clear_cache`

All read tools accept response_format ("markdown" or "json", default: "markdown").

Full reference: docs/reference/API.md

Configuration

Variable	Default	Description
`YNAB_ACCESS_TOKEN`	—	Required. Your YNAB personal access token.
`YNAB_EXPORT_PATH`	`~/Downloads`	Directory for exported transaction files.
`YNAB_MCP_ENABLE_DELTA`	`false`	Set to `true` to enable delta sync (only fetch changed data). Must be exactly `true` or `false`.
`YNAB_MCP_WRITE_MODE`	`preview`	`read-only` hides YNAB mutations; `preview` requires exact confirmation; `enabled` permits direct writes.
`YNAB_MCP_TOOL_PROFILE`	`full`	`core`, `read-only`, or `full` startup tool surface.
`YNAB_MCP_CACHE_DEFAULT_TTL_MS`	`300000`	Cache TTL in milliseconds (5 min).
`YNAB_MCP_CACHE_MAX_ENTRIES`	`1000`	Maximum cache entries before LRU eviction.

See .env.example for all options.

Write modes and compatibility

preview is the conservative default. A mutation call first runs its existing dry_run path and returns a confirmation token. That token expires after two minutes, can be used once, and only authorizes the same canonical tool name and validated arguments. read-only does not register YNAB mutation tools. enabled preserves the pre-safety direct-write behavior for users who explicitly opt in.

Transaction amounts now prefer amount_decimal (for example, -12.34) or the explicit raw field amount_milliunits (-12340). Category funding similarly prefers budgeted_decimal or budgeted_milliunits. The old amount and budgeted fields remain accepted as deprecated milliunit aliases for backward compatibility; their meaning is never guessed.

Tool profiles

Profiles are selected once at server startup, so clients receive a stable tools/list response:

core keeps common reads, transaction safety workflows, reconciliation, receipt splitting, scheduled review, and spending analytics.
read-only exposes every tool explicitly annotated read-only.
full exposes the complete 35-tool surface, subject to the selected write mode.

Privacy and trust

The server process runs locally and communicates with YNAB over YNAB's API.
Your YNAB personal access token is sensitive. Store it in your MCP client's secret configuration and never paste it into a conversation, issue, fixture, or log.
Financial data returned by tools and included in a conversation may be processed by the AI provider selected in your MCP client. Review that provider's data controls before sharing sensitive details.
Transaction exports remain on local disk at YNAB_EXPORT_PATH (or the platform default). The server does not upload exported files elsewhere.
Use read-only for no YNAB writes, preview for exact request confirmation, or enabled only when direct writes are an intentional compatibility choice.
This independent open-source project is not affiliated with or endorsed by YNAB.

Troubleshooting

Symptom	Fix
`npx` fails	Install Node.js 24+, then restart your MCP client.
Auth errors	Regenerate your YNAB token and update `YNAB_ACCESS_TOKEN`.
Tools not detected	Restart the MCP client after any config change.
Reconciliation issues	Open an issue with an anonymized CSV sample.

For developers

git clone https://github.com/dizzlkheinz/ynab-mcpb.git

cd ynab-mcpb npm ci --ignore-scripts npm run build npm test npm run test:integration

The build and offline tests require no YNAB credentials. npm test runs unit and performance tests; test:integration runs mocked integration tests. Use test:all, test:coverage, or test:watch for the combined suite, coverage, or watch mode. Pass file/test-name filters directly, for example npm run test:integration -- transactionTools.

To start the server locally, copy .env.example to .env, add your token, and run npm start. Live smoke tests require an explicit RUN_LIVE_YNAB_TESTS=true and run through npm run test:live; SKIP_E2E_TESTS=true disables them.

Builds do not package or install global tools. To create a Claude Desktop bundle, install the official CLI once (npm install --global @anthropic-ai/mcpb), then run npm run build and npm run package:mcpb. Review npm package contents with npm pack --dry-run --ignore-scripts.

Architecture and contributor guidance: CLAUDE.md

Reconciliation architecture: docs/technical/reconciliation-system-architecture.md

Contributing

Bug reports and CSV edge-case repros are very welcome, especially for bank reconciliation: Open an issue

PRs welcome — run npm test and npm run lint before submitting.

License

AGPL-3.0

Ynab Mcpb

ภาพรวม

สามเสาของ PopNx MCP

ใช้ทำอะไรได้

ติดตั้ง

ก่อนติดตั้ง

ค่าที่ต้องใส่เอง

ทำอะไรได้บ้าง

ผลตรวจเบื้องต้นi

ตัวตนผู้ทำตรงกับ repo

ยังมีคนดูแล

มีสัญญาอนุญาต (license)

endpoint ตอบ

ล็อกอินแบบ OAuth

คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

เทียบกับตัวอื่นในหมวด อื่น ๆi

คำถามที่พบบ่อย

ตัวที่ใช้แทนได้

Spec Driven Development

Remote Desktop Commander

Tethered Trust

README จากผู้ทำ

YNAB MCP Server

Demo

What you can do

How it works

Features

How reconciliation works

Setup (2 minutes)

1 — Get a YNAB token

2 — Install

3 — Try these prompts

Tools (35)

Configuration

Write modes and compatibility

Tool profiles

Privacy and trust

Troubleshooting

For developers

Contributing

License