@oliverames/ynab-mcp-server 1.2.0 → 1.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Oliver Ames
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -10,19 +10,31 @@
 </p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/@oliverames/ynab-mcp-server"><img src="https://img.shields.io/npm/v/@oliverames/ynab-mcp-server" alt="npm version"></a>
-  <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-blue" alt="MCP compatible"></a>
-  <a href="https://api.ynab.com"><img src="https://img.shields.io/badge/YNAB%20API-v1.79-green" alt="YNAB API v1.79"></a>
-  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-brightgreen" alt="License: MIT"></a>
+  <code>43 tools</code> &bull;
+  <code>100% API coverage</code> &bull;
+  <code>YNAB API v1.79</code>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@oliverames/ynab-mcp-server"><img src="https://img.shields.io/npm/v/%40oliverames%2Fynab-mcp-server?style=flat-square&color=f5a542" alt="npm"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-f5a542?style=flat-square" alt="License"></a>
+  <a href="https://www.buymeacoffee.com/oliverames"><img src="https://img.shields.io/badge/Buy_Me_a_Coffee-support-f5a542?style=flat-square&logo=buy-me-a-coffee&logoColor=white" alt="Buy Me a Coffee"></a>
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick Start</a> &bull;
+  <a href="#what-you-can-do">What You Can Do</a> &bull;
+  <a href="#tools-reference">All 43 Tools</a> &bull;
+  <a href="#environment-variables">Configuration</a>
 </p>
 
 ---
 
-**43 tools. 100% API coverage. Zero configuration.**
+## Why This Exists
 
-Connect any MCP-compatible AI assistant — Claude, GPT, or your own agents — to your YNAB budget. Read transactions, categorize spending, manage accounts, review scheduled payments, track money movements, and more. All monetary values are automatically converted between dollars and YNAB's internal milliunits format so the AI never has to think about it.
+YNAB's budgeting philosophy works best when you interact with your budget frequently — but the app interface isn't designed for quick queries or bulk operations. "How much did I spend on groceries this month?" shouldn't require navigating three screens. "Categorize all my Amazon orders from this week" shouldn't be a manual, one-by-one process.
 
-Built on the [official YNAB JavaScript SDK](https://github.com/ynab/ynab-sdk-js) with direct API calls for the newest endpoints (category creation, category groups, money movements) that the SDK hasn't caught up with yet.
+This server gives your AI assistant full access to YNAB's API, turning natural language into budget operations. All monetary values are automatically converted between dollars and YNAB's internal milliunits format so the AI never has to think about it. Built on the [official YNAB JavaScript SDK](https://github.com/ynab/ynab-sdk-js) with direct API calls for the newest endpoints (category creation, category groups, money movements) that the SDK hasn't caught up with yet.
 
 ---
 
@@ -132,7 +144,9 @@ That's it. Your AI can now talk to YNAB.
 - **Bulk operations** — `create_transactions` and `update_transactions` handle arrays in a single API call.
 - **Fetch-then-merge updates** — scheduled transaction updates (which use PUT semantics) automatically fetch the current state and merge your changes, so you only specify what changed.
 - **Fuzzy search** — `search_categories` and `search_payees` do case-insensitive partial matching across all entries.
-- **Approval workflow** — `review_unapproved` groups transactions into "ready to approve" (has category) and "needs attention" (uncategorized), with a built-in warning against approving uncategorized entries.
+- **Approval workflow** — `review_unapproved` groups transactions into "ready to approve" (categorized, split, or transfer) and "needs attention" (uncategorized), with a built-in warning against approving uncategorized entries.
+- **Nullable updates** — update tools accept `null` for clearable fields (`memo`, `payeeName`, `categoryId`, `flagColor`) to distinguish "don't change" (omit) from "clear this field" (`null`).
+- **Debt account support** — loan and debt accounts include `debt_original_balance`, `debt_interest_rates`, `debt_minimum_payments`, and `debt_escrow_amounts` with correct unit conversion (rates stay as percentages, payments convert from milliunits).
 
 ---
 
@@ -143,7 +157,7 @@ That's it. Your AI can now talk to YNAB.
 | Tool | Description |
 |------|-------------|
 | `get_user` | Get the authenticated user |
-| `list_budgets` | List all budgets with IDs, names, and date ranges |
+| `list_budgets` | List all budgets with IDs, names, date ranges, format settings, and default budget |
 | `get_budget` | Get budget summary (name, currency, account/category/payee counts) |
 | `get_budget_settings` | Get currency and date format settings |
 
@@ -151,8 +165,8 @@ That's it. Your AI can now talk to YNAB.
 
 | Tool | Description |
 |------|-------------|
-| `list_accounts` | List all accounts with balances in dollars |
-| `get_account` | Get details for a specific account |
+| `list_accounts` | List all accounts with balances, debt details, and import status |
+| `get_account` | Get full account details including notes and debt fields |
 | `create_account` | Create a new account (checking, savings, creditCard, mortgage, etc.) |
 
 **Supported account types:** `checking`, `savings`, `cash`, `creditCard`, `lineOfCredit`, `otherAsset`, `otherLiability`, `mortgage`, `autoLoan`, `studentLoan`, `personalLoan`, `medicalDebt`, `otherDebt`
@@ -165,7 +179,7 @@ That's it. Your AI can now talk to YNAB.
 | `get_category` | Get full category details including goal progress and cadence |
 | `get_month_category` | Get category budget for a specific month |
 | `update_month_category` | Set the budgeted amount for a category in a month |
-| `update_category` | Update name, note, goal target, or move to a different group |
+| `update_category` | Update name, note, goal target, goal target date, or move to a different group |
 | `create_category` | Create a new category in an existing group (with optional goal) |
 | `create_category_group` | Create a new category group |
 | `update_category_group` | Rename a category group |
@@ -192,8 +206,8 @@ That's it. Your AI can now talk to YNAB.
 
 | Tool | Description |
 |------|-------------|
-| `list_months` | List budget months with income, budgeted, activity, to-be-budgeted, age of money |
-| `get_month` | Get month detail with per-category budget/activity/balance breakdown |
+| `list_months` | List budget months with income, budgeted, activity, to-be-budgeted, age of money, and notes |
+| `get_month` | Get month detail with per-category budget/activity/balance/goal breakdown |
 
 ### Money Movements
 
@@ -211,7 +225,7 @@ That's it. Your AI can now talk to YNAB.
 | `get_transactions` | Get transactions with filters: by account, category, payee, month, or status (`unapproved`/`uncategorized`) |
 | `get_transaction` | Get a single transaction by ID (includes subtransactions) |
 | `create_transaction` | Create a transaction with optional split (subtransactions must sum to total) |
-| `create_transactions` | Bulk create multiple transactions in a single API call |
+| `create_transactions` | Bulk create multiple transactions in a single API call (supports split transactions) |
 | `update_transaction` | Partial update — only specified fields change |
 | `update_transactions` | Batch update multiple transactions at once |
 | `delete_transaction` | Delete a transaction |
@@ -233,7 +247,7 @@ That's it. Your AI can now talk to YNAB.
 
 | Tool | Description |
 |------|-------------|
-| `review_unapproved` | Get unapproved transactions grouped by readiness: "ready to approve" (categorized) vs. "needs category first" (uncategorized). Includes a warning against blind approval. |
+| `review_unapproved` | Get unapproved transactions grouped by readiness: "ready to approve" (categorized, split, or transfer) vs. "needs category first" (uncategorized). Includes a warning against blind approval. |
 
 ---
 
@@ -316,3 +330,20 @@ Zero additional dependencies. No build step. Pure ESM.
 ## License
 
 MIT
+
+---
+
+<p align="center">
+  <a href="https://www.buymeacoffee.com/oliverames">
+    <img src="https://img.shields.io/badge/Buy_Me_a_Coffee-support-f5a542?style=for-the-badge&logo=buy-me-a-coffee&logoColor=white" alt="Buy Me a Coffee">
+  </a>
+</p>
+
+<p align="center">
+  <sub>
+    Built by <a href="https://ames.consulting">Oliver Ames</a> in Vermont
+    &bull; <a href="https://github.com/oliverames">GitHub</a>
+    &bull; <a href="https://linkedin.com/in/oliverames">LinkedIn</a>
+    &bull; <a href="https://bsky.app/profile/oliverames.bsky.social">Bluesky</a>
+  </sub>
+</p>

package/index.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 
+import { execFileSync } from "node:child_process";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
@@ -7,9 +8,19 @@ import * as ynab from "ynab";
 
 // --- Init ---
 
-const API_TOKEN = process.env.YNAB_API_TOKEN;
+let API_TOKEN = process.env.YNAB_API_TOKEN;
 if (!API_TOKEN) {
-  console.error("YNAB_API_TOKEN environment variable is required");
+  try {
+    API_TOKEN = execFileSync(
+      "op", ["read", "op://Development/YNAB API Token/credential"],
+      { encoding: "utf-8", timeout: 10000, stdio: ["pipe", "pipe", "pipe"] }
+    ).trim();
+  } catch {
+    // 1Password CLI unavailable or item not found
+  }
+}
+if (!API_TOKEN) {
+  console.error("YNAB_API_TOKEN environment variable is required (1Password fallback also failed)");
   process.exit(1);
 }
 
@@ -31,6 +42,36 @@ function milliunits(dollars) {
   return Math.round(dollars * 1000);
 }
 
+function dollarsMap(obj) {
+  return obj ? Object.fromEntries(Object.entries(obj).map(([k, v]) => [k, dollars(v)])) : obj;
+}
+
+function mapTransactionInput(t) {
+  const out = {
+    account_id: t.accountId,
+    date: t.date,
+    amount: milliunits(t.amount),
+    payee_id: t.payeeId,
+    payee_name: t.payeeName,
+    category_id: t.categoryId,
+    memo: t.memo,
+    cleared: t.cleared,
+    approved: t.approved,
+    flag_color: t.flagColor,
+    import_id: t.importId,
+  };
+  if (t.subtransactions) {
+    out.subtransactions = t.subtransactions.map((s) => ({
+      amount: milliunits(s.amount),
+      category_id: s.categoryId,
+      payee_id: s.payeeId,
+      payee_name: s.payeeName,
+      memo: s.memo,
+    }));
+  }
+  return out;
+}
+
 function ok(data) {
   return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
 }
@@ -70,7 +111,7 @@ async function ynabFetch(path, { method = "GET", body } = {}) {
 
 const server = new McpServer({
   name: "ynab-mcp-server",
-  version: "1.2.0",
+  version: "1.2.1",
 });
 
 // ==================== User & Budgets ====================
@@ -85,7 +126,13 @@ server.tool("get_user", "Get the authenticated user", {}, () =>
 server.tool("list_budgets", "List all budgets. Use a budget ID from the results in other tools, or omit budgetId to use the last-used budget.", {}, () =>
   run(async () => {
     const { data } = await api.budgets.getBudgets();
-    return ok(data.budgets.map((b) => ({ id: b.id, name: b.name, last_modified_on: b.last_modified_on, first_month: b.first_month, last_month: b.last_month })));
+    const result = {
+      budgets: data.budgets.map((b) => ({ id: b.id, name: b.name, last_modified_on: b.last_modified_on, first_month: b.first_month, last_month: b.last_month, date_format: b.date_format, currency_format: b.currency_format })),
+    };
+    if (data.default_budget) {
+      result.default_budget = { id: data.default_budget.id, name: data.default_budget.name };
+    }
+    return ok(result);
   })
 );
 
@@ -139,6 +186,10 @@ function formatAccount(a) {
     direct_import_linked: a.direct_import_linked,
     direct_import_in_error: a.direct_import_in_error,
     last_reconciled_at: a.last_reconciled_at,
+    debt_original_balance: dollars(a.debt_original_balance),
+    debt_interest_rates: a.debt_interest_rates,
+    debt_minimum_payments: dollarsMap(a.debt_minimum_payments),
+    debt_escrow_amounts: dollarsMap(a.debt_escrow_amounts),
     deleted: a.deleted,
   };
   if ("note" in a) out.note = a.note;
@@ -195,6 +246,7 @@ function formatCategory(c) {
     id: c.id,
     category_group_id: c.category_group_id,
     category_group_name: c.category_group_name,
+    original_category_group_id: c.original_category_group_id,
     name: c.name,
     hidden: c.hidden,
     note: c.note,
@@ -214,6 +266,7 @@ function formatCategory(c) {
     goal_overall_funded: dollars(c.goal_overall_funded),
     goal_overall_left: dollars(c.goal_overall_left),
     goal_needs_whole_amount: c.goal_needs_whole_amount,
+    deleted: c.deleted,
   };
 }
 
@@ -229,6 +282,7 @@ server.tool(
           id: g.id,
           name: g.name,
           hidden: g.hidden,
+          deleted: g.deleted,
           categories: g.categories.map((c) => ({
             id: c.id,
             name: c.name,
@@ -237,6 +291,7 @@ server.tool(
             activity: dollars(c.activity),
             balance: dollars(c.balance),
             goal_type: c.goal_type,
+            deleted: c.deleted,
           })),
         }))
       );
@@ -300,14 +355,16 @@ server.tool(
     note: z.string().nullable().optional().describe("Category note (null to clear)"),
     categoryGroupId: z.string().optional().describe("Move to a different category group"),
     goalTarget: z.number().nullable().optional().describe("Goal target amount in dollars (only if category already has a goal)"),
+    goalTargetDate: z.string().nullable().optional().describe("Goal target date in ISO format (e.g. 2026-12-01, null to clear)"),
   },
-  ({ budgetId, categoryId, name, note, categoryGroupId, goalTarget }) =>
+  ({ budgetId, categoryId, name, note, categoryGroupId, goalTarget, goalTargetDate }) =>
     run(async () => {
       const cat = {};
       if (name !== undefined) cat.name = name;
       if (note !== undefined) cat.note = note;
       if (categoryGroupId !== undefined) cat.category_group_id = categoryGroupId;
       if (goalTarget !== undefined) cat.goal_target = goalTarget != null ? milliunits(goalTarget) : null;
+      if (goalTargetDate !== undefined) cat.goal_target_date = goalTargetDate;
 
       const { data } = await api.categories.updateCategory(resolveBudgetId(budgetId), categoryId, {
         category: cat,
@@ -386,7 +443,7 @@ server.tool(
   ({ budgetId }) =>
     run(async () => {
       const { data } = await api.payees.getPayees(resolveBudgetId(budgetId));
-      return ok(data.payees.map((p) => ({ id: p.id, name: p.name, transfer_account_id: p.transfer_account_id })));
+      return ok(data.payees.map((p) => ({ id: p.id, name: p.name, transfer_account_id: p.transfer_account_id, deleted: p.deleted })));
     })
 );
 
@@ -474,11 +531,13 @@ server.tool(
       return ok(
         data.months.map((m) => ({
           month: m.month,
+          note: m.note,
           income: dollars(m.income),
           budgeted: dollars(m.budgeted),
           activity: dollars(m.activity),
           to_be_budgeted: dollars(m.to_be_budgeted),
           age_of_money: m.age_of_money,
+          deleted: m.deleted,
         }))
       );
     })
@@ -497,14 +556,17 @@ server.tool(
       const m = data.month;
       return ok({
         month: m.month,
+        note: m.note,
         income: dollars(m.income),
         budgeted: dollars(m.budgeted),
         activity: dollars(m.activity),
         to_be_budgeted: dollars(m.to_be_budgeted),
         age_of_money: m.age_of_money,
+        deleted: m.deleted,
         categories: m.categories?.map((c) => ({
           id: c.id,
           name: c.name,
+          hidden: c.hidden,
           category_group_name: c.category_group_name,
           budgeted: dollars(c.budgeted),
           activity: dollars(c.activity),
@@ -512,6 +574,7 @@ server.tool(
           goal_type: c.goal_type,
           goal_target: dollars(c.goal_target),
           goal_under_funded: dollars(c.goal_under_funded),
+          deleted: c.deleted,
         })),
       });
     })
@@ -530,6 +593,7 @@ function formatMoneyMovement(m) {
     from_category_id: m.from_category_id,
     to_category_id: m.to_category_id,
     amount: dollars(m.amount),
+    deleted: m.deleted,
   };
 }
 
@@ -602,17 +666,25 @@ function formatTransaction(t) {
     category_id: t.category_id,
     category_name: t.category_name,
     transfer_account_id: t.transfer_account_id,
+    transfer_transaction_id: t.transfer_transaction_id,
+    matched_transaction_id: t.matched_transaction_id,
     import_id: t.import_id,
     import_payee_name: t.import_payee_name,
+    import_payee_name_original: t.import_payee_name_original,
     debt_transaction_type: t.debt_transaction_type,
+    deleted: t.deleted,
     subtransactions: t.subtransactions?.map((s) => ({
       id: s.id,
+      transaction_id: s.transaction_id,
       amount: dollars(s.amount),
       memo: s.memo,
       payee_id: s.payee_id,
       payee_name: s.payee_name,
       category_id: s.category_id,
       category_name: s.category_name,
+      transfer_account_id: s.transfer_account_id,
+      transfer_transaction_id: s.transfer_transaction_id,
+      deleted: s.deleted,
     })),
   };
 }
@@ -693,32 +765,10 @@ server.tool(
       memo: z.string().optional().describe("Memo"),
     })).optional().describe("Split transaction into subtransactions. The subtransaction amounts must sum to the total transaction amount."),
   },
-  ({ budgetId, accountId, date, amount, payeeId, payeeName, categoryId, memo, cleared, approved, flagColor, importId, subtransactions }) =>
+  ({ budgetId, ...txnFields }) =>
     run(async () => {
-      const txn = {
-        account_id: accountId,
-        date,
-        amount: milliunits(amount),
-        payee_id: payeeId,
-        payee_name: payeeName,
-        category_id: categoryId,
-        memo,
-        cleared,
-        approved,
-        flag_color: flagColor,
-        import_id: importId,
-      };
-      if (subtransactions) {
-        txn.subtransactions = subtransactions.map((s) => ({
-          amount: milliunits(s.amount),
-          category_id: s.categoryId,
-          payee_id: s.payeeId,
-          payee_name: s.payeeName,
-          memo: s.memo,
-        }));
-      }
       const { data } = await api.transactions.createTransaction(resolveBudgetId(budgetId), {
-        transaction: txn,
+        transaction: mapTransactionInput(txnFields),
       });
       return ok(formatTransaction(data.transaction));
     })
@@ -741,25 +791,19 @@ server.tool(
       approved: z.boolean().optional().describe("Whether transaction is approved"),
       flagColor: z.enum(["red", "orange", "yellow", "green", "blue", "purple"]).optional().describe("Flag color"),
       importId: z.string().optional().describe("Unique import ID for deduplication (max 36 chars)"),
+      subtransactions: z.array(z.object({
+        amount: z.number().describe("Subtransaction amount in dollars"),
+        categoryId: z.string().optional().describe("Category ID"),
+        payeeId: z.string().optional().describe("Payee ID"),
+        payeeName: z.string().optional().describe("Payee name"),
+        memo: z.string().optional().describe("Memo"),
+      })).optional().describe("Split transaction into subtransactions"),
     })).describe("Array of transactions to create"),
   },
   ({ budgetId, transactions: txns }) =>
     run(async () => {
-      const mapped = txns.map((t) => ({
-        account_id: t.accountId,
-        date: t.date,
-        amount: milliunits(t.amount),
-        payee_id: t.payeeId,
-        payee_name: t.payeeName,
-        category_id: t.categoryId,
-        memo: t.memo,
-        cleared: t.cleared,
-        approved: t.approved,
-        flag_color: t.flagColor,
-        import_id: t.importId,
-      }));
       const { data } = await api.transactions.createTransactions(resolveBudgetId(budgetId), {
-        transactions: mapped,
+        transactions: txns.map(mapTransactionInput),
       });
       return ok({
         created: data.transactions?.map(formatTransaction),
@@ -777,10 +821,10 @@ server.tool(
     accountId: z.string().optional().describe("Account ID"),
     date: z.string().optional().describe("Transaction date (YYYY-MM-DD)"),
     amount: z.number().optional().describe("Amount in dollars"),
-    payeeId: z.string().optional().describe("Payee ID"),
-    payeeName: z.string().optional().describe("Payee name"),
+    payeeId: z.string().nullable().optional().describe("Payee ID (null to remove)"),
+    payeeName: z.string().nullable().optional().describe("Payee name (null to clear)"),
     categoryId: z.string().nullable().optional().describe("Category ID (null to uncategorize)"),
-    memo: z.string().optional().describe("Transaction memo"),
+    memo: z.string().nullable().optional().describe("Transaction memo (null to clear)"),
     cleared: z.enum(["cleared", "uncleared", "reconciled"]).optional().describe("Cleared status"),
     approved: z.boolean().optional().describe("Whether transaction is approved"),
     flagColor: z.enum(["red", "orange", "yellow", "green", "blue", "purple"]).nullable().optional().describe("Flag color (null to remove)"),
@@ -829,16 +873,16 @@ server.tool(
       .array(
         z.object({
           id: z.string().describe("Transaction ID"),
-          account_id: z.string().optional(),
-          date: z.string().optional(),
+          accountId: z.string().optional().describe("Account ID"),
+          date: z.string().optional().describe("Transaction date (YYYY-MM-DD)"),
           amount: z.number().optional().describe("Amount in dollars"),
-          payee_id: z.string().optional(),
-          payee_name: z.string().optional(),
-          category_id: z.string().optional(),
-          memo: z.string().optional(),
-          cleared: z.enum(["cleared", "uncleared", "reconciled"]).optional(),
-          approved: z.boolean().optional(),
-          flag_color: z.enum(["red", "orange", "yellow", "green", "blue", "purple"]).nullable().optional(),
+          payeeId: z.string().nullable().optional().describe("Payee ID (null to remove)"),
+          payeeName: z.string().nullable().optional().describe("Payee name (null to clear)"),
+          categoryId: z.string().nullable().optional().describe("Category ID (null to uncategorize)"),
+          memo: z.string().nullable().optional().describe("Transaction memo (null to clear)"),
+          cleared: z.enum(["cleared", "uncleared", "reconciled"]).optional().describe("Cleared status"),
+          approved: z.boolean().optional().describe("Whether transaction is approved"),
+          flagColor: z.enum(["red", "orange", "yellow", "green", "blue", "purple"]).nullable().optional().describe("Flag color (null to remove)"),
         })
       )
       .describe("Array of transaction updates"),
@@ -846,8 +890,17 @@ server.tool(
   ({ budgetId, transactions: txns }) =>
     run(async () => {
       const mapped = txns.map((t) => {
-        const out = { ...t };
-        if (out.amount !== undefined) out.amount = milliunits(out.amount);
+        const out = { id: t.id };
+        if (t.accountId !== undefined) out.account_id = t.accountId;
+        if (t.date !== undefined) out.date = t.date;
+        if (t.amount !== undefined) out.amount = milliunits(t.amount);
+        if (t.payeeId !== undefined) out.payee_id = t.payeeId;
+        if (t.payeeName !== undefined) out.payee_name = t.payeeName;
+        if (t.categoryId !== undefined) out.category_id = t.categoryId;
+        if (t.memo !== undefined) out.memo = t.memo;
+        if (t.cleared !== undefined) out.cleared = t.cleared;
+        if (t.approved !== undefined) out.approved = t.approved;
+        if (t.flagColor !== undefined) out.flag_color = t.flagColor;
         return out;
       });
       const { data } = await api.transactions.updateTransactions(resolveBudgetId(budgetId), {
@@ -890,14 +943,18 @@ function formatScheduledTransaction(t) {
     category_id: t.category_id,
     category_name: t.category_name,
     transfer_account_id: t.transfer_account_id,
+    deleted: t.deleted,
     subtransactions: t.subtransactions?.map((s) => ({
       id: s.id,
+      scheduled_transaction_id: s.scheduled_transaction_id,
       amount: dollars(s.amount),
       memo: s.memo,
       payee_id: s.payee_id,
       payee_name: s.payee_name,
       category_id: s.category_id,
       category_name: s.category_name,
+      transfer_account_id: s.transfer_account_id,
+      deleted: s.deleted,
     })),
   };
 }
@@ -1067,7 +1124,7 @@ server.tool(
       const q = query.toLowerCase();
       const matches = data.payees
         .filter((p) => p.name.toLowerCase().includes(q))
-        .map((p) => ({ id: p.id, name: p.name, transfer_account_id: p.transfer_account_id }));
+        .map((p) => ({ id: p.id, name: p.name, transfer_account_id: p.transfer_account_id, deleted: p.deleted }));
       if (matches.length === 0) return ok({ message: `No payees matching "${query}"` });
       return ok(matches);
     })
@@ -1081,8 +1138,11 @@ server.tool(
     run(async () => {
       const { data } = await api.transactions.getTransactions(resolveBudgetId(budgetId), undefined, "unapproved");
       const txns = data.transactions.map(formatTransaction);
-      const categorized = txns.filter((t) => t.category_id && t.category_name !== "Uncategorized");
-      const uncategorized = txns.filter((t) => !t.category_id || t.category_name === "Uncategorized");
+      const isCategorized = (t) => (t.category_id && t.category_name !== "Uncategorized")
+        || (t.subtransactions && t.subtransactions.length > 0) // split transactions are categorized via subtransactions
+        || t.transfer_account_id; // transfers don't need categories
+      const categorized = txns.filter(isCategorized);
+      const uncategorized = txns.filter((t) => !isCategorized(t));
       return ok({
         total: txns.length,
         ready_to_approve: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oliverames/ynab-mcp-server",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "YNAB MCP server with full API coverage",
   "type": "module",
   "main": "index.js",
@@ -12,7 +12,8 @@
   ],
   "scripts": {
     "start": "node index.js",
-    "test": "node test.js"
+    "test": "node test.js",
+    "postpublish": "$HOME/Developer/projects/ames-claude/bump-and-sync"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",