ynab-mcp

Instructions

Implementation Reference

• src/tools/transactions.ts:274-291 (handler)

  The implementation of the 'import_transactions' tool, including its registration, input schema, and handler logic.

  server.registerTool("import_transactions", {
    title: "Import Transactions",
    description: "[1 API call] Trigger an import of transactions from linked financial institutions",
    inputSchema: {
      budget_id: z.string().default("last-used").describe("Budget ID or 'last-used'"),
    },
    annotations: { readOnlyHint: false },
  }, async ({ budget_id }) => {
    try {
      const response = await getClient().transactions.importTransactions(budget_id);
      const data = response.data;
      return textResult(
        `Import complete:\n  Transaction IDs imported: ${data.transaction_ids?.length ?? 0}`
      );
    } catch (e: any) {
      return errorResult(e.message);
    }
  });