@achmadya-dev/mcp-excel-query 0.3.0

package/dist/tools/excel_set_data_validation.js

@@ -0,0 +1,126 @@
+import { defineTool, ToolError } from "@achmadya-dev/mcp-core";
+import { z } from "zod";
+import { Excel } from "../excel/excel.js";
+import { Range } from "../excel/range.js";
+const filePathField = z.string().describe("Absolute path to the local Excel file (.xlsx)");
+const sheetNameOptional = z
+    .string()
+    .optional()
+    .describe("Name of the worksheet (defaults to the first sheet)");
+const validationOperatorSchema = z.enum([
+    "between",
+    "notBetween",
+    "equal",
+    "notEqual",
+    "greaterThan",
+    "lessThan",
+    "greaterThanOrEqual",
+    "lessThanOrEqual",
+]);
+const setDataValidationInputSchema = z.object({
+    filePath: filePathField,
+    sheetName: sheetNameOptional,
+    startCell: z.string(),
+    endCell: z.string().optional(),
+    range: z.string().optional(),
+    clear: z.boolean().optional().describe("Remove data validation from the range"),
+    type: z
+        .enum(["list", "whole", "decimal", "date", "textLength", "custom"])
+        .optional()
+        .describe("Validation type (required unless clear:true)"),
+    operator: validationOperatorSchema.optional(),
+    formulae: z
+        .array(z.string())
+        .optional()
+        .describe('Formula strings, e.g. ["\\"Yes,No\\""] for list or ["=A1>0"] for custom'),
+    allowBlank: z.boolean().optional(),
+    showInputMessage: z.boolean().optional(),
+    prompt: z.string().optional(),
+    promptTitle: z.string().optional(),
+    showErrorMessage: z.boolean().optional(),
+    error: z.string().optional(),
+    errorTitle: z.string().optional(),
+});
+const operationResultOutputShape = z.object({
+    success: z.boolean(),
+    message: z.string(),
+});
+function boundsFromParams(params) {
+    return params.range ? Range.parse(params.range) : Range.between(params.startCell, params.endCell);
+}
+function applyValidationToCell(cell, params) {
+    const validation = {
+        type: params.type,
+        formulae: params.formulae ?? [],
+        ...(params.operator ? { operator: params.operator } : {}),
+        ...(params.allowBlank !== undefined ? { allowBlank: params.allowBlank } : {}),
+        ...(params.showInputMessage !== undefined ? { showInputMessage: params.showInputMessage } : {}),
+        ...(params.prompt ? { prompt: params.prompt } : {}),
+        ...(params.promptTitle ? { promptTitle: params.promptTitle } : {}),
+        ...(params.showErrorMessage !== undefined ? { showErrorMessage: params.showErrorMessage } : {}),
+        ...(params.error ? { error: params.error } : {}),
+        ...(params.errorTitle ? { errorTitle: params.errorTitle } : {}),
+    };
+    cell.dataValidation = validation;
+}
+export const excel_set_data_validation = defineTool({
+    name: "excel_set_data_validation",
+    description: "Set or clear data validation on a range. Supports list, whole, decimal, date, textLength, and custom rules with formulae.",
+    inputSchema: setDataValidationInputSchema,
+    outputSchema: operationResultOutputShape,
+    handler: async (args) => {
+        try {
+            const excel = await Excel.open(args.filePath);
+            const sheet = excel.sheet(args.sheetName);
+            const worksheet = sheet.raw;
+            const bounds = boundsFromParams(args);
+            for (let r = bounds.startRow; r <= bounds.endRow; r++) {
+                for (let c = bounds.startCol; c <= bounds.endCol; c++) {
+                    const cell = worksheet.getCell(r, c);
+                    if (args.clear) {
+                        const address = cell.address;
+                        const validations = worksheet.dataValidations;
+                        validations.remove(address);
+                        delete validations.model[address];
+                        continue;
+                    }
+                    if (!args.type) {
+                        throw new Error("type is required when setting data validation");
+                    }
+                    if (!args.formulae || args.formulae.length === 0) {
+                        throw new Error("formulae is required when setting data validation");
+                    }
+                    applyValidationToCell(cell, {
+                        type: args.type,
+                        operator: args.operator,
+                        formulae: args.formulae,
+                        allowBlank: args.allowBlank,
+                        showInputMessage: args.showInputMessage,
+                        prompt: args.prompt,
+                        promptTitle: args.promptTitle,
+                        showErrorMessage: args.showErrorMessage,
+                        error: args.error,
+                        errorTitle: args.errorTitle,
+                    });
+                }
+            }
+            await excel.save();
+            const rangeLabel = args.range ?? `${args.startCell}${args.endCell ? `:${args.endCell}` : ""}`;
+            if (args.clear) {
+                return {
+                    success: true,
+                    message: `Cleared data validation on sheet '${worksheet.name}' at ${rangeLabel}`,
+                };
+            }
+            return {
+                success: true,
+                message: `Set ${args.type} data validation on sheet '${worksheet.name}' at ${rangeLabel}`,
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ToolError("Failed to set data validation: " + msg);
+        }
+    },
+});
+//# sourceMappingURL=excel_set_data_validation.js.map

package/dist/tools/excel_set_data_validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel_set_data_validation.js","sourceRoot":"","sources":["../../src/tools/excel_set_data_validation.ts"],"names":[],"mappings":"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"}

package/dist/tools/excel_set_dimensions.d.ts

@@ -0,0 +1,2 @@
+export declare const excel_set_dimensions: import("@achmadya-dev/mcp-core").RegisterableTool;
+//# sourceMappingURL=excel_set_dimensions.d.ts.map

package/dist/tools/excel_set_dimensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel_set_dimensions.d.ts","sourceRoot":"","sources":["../../src/tools/excel_set_dimensions.ts"],"names":[],"mappings":"AAsGA,eAAO,MAAM,oBAAoB,mDAiF/B,CAAC"}

package/dist/tools/excel_set_dimensions.js

@@ -0,0 +1,134 @@
+import { defineTool, ToolError } from "@achmadya-dev/mcp-core";
+import { z } from "zod";
+import { Excel } from "../excel/excel.js";
+import { Range } from "../excel/range.js";
+const filePathField = z.string().describe("Absolute path to the local Excel file (.xlsx)");
+const sheetNameOptional = z
+    .string()
+    .optional()
+    .describe("Name of the worksheet (defaults to the first sheet)");
+const setDimensionsInputSchema = z.object({
+    filePath: filePathField,
+    sheetName: sheetNameOptional,
+    range: z.string().optional(),
+    startCell: z.string().optional(),
+    endCell: z.string().optional(),
+    rows: z.array(z.number()).optional().describe("1-based row numbers for rowHeight"),
+    columns: z
+        .array(z.union([z.number(), z.string()]))
+        .optional()
+        .describe("1-based column indexes or letters for columnWidth"),
+    rowHeight: z.number().optional().describe("Row height in points"),
+    columnWidth: z.number().optional().describe("Column width in Excel character units"),
+    defaultRowHeight: z.number().optional().describe("Sheet default row height"),
+    defaultColumnWidth: z.number().optional().describe("Sheet default column width"),
+});
+const operationResultOutputShape = z.object({
+    success: z.boolean(),
+    message: z.string(),
+});
+function columnIndex(column) {
+    if (typeof column === "number") {
+        if (!Number.isInteger(column) || column < 1) {
+            throw new Error(`Invalid column index: ${column}`);
+        }
+        return column;
+    }
+    return Range.letterToCol(column);
+}
+function collectTargetRows(params) {
+    if (params.rows && params.rows.length > 0) {
+        return params.rows;
+    }
+    if (params.range) {
+        const bounds = Range.parse(params.range);
+        return Array.from({ length: bounds.endRow - bounds.startRow + 1 }, (_, i) => bounds.startRow + i);
+    }
+    if (params.startCell) {
+        const bounds = Range.between(params.startCell, params.endCell);
+        return Array.from({ length: bounds.endRow - bounds.startRow + 1 }, (_, i) => bounds.startRow + i);
+    }
+    return [];
+}
+function collectTargetColumns(params) {
+    if (params.columns && params.columns.length > 0) {
+        return params.columns.map(columnIndex);
+    }
+    if (params.range) {
+        const bounds = Range.parse(params.range);
+        return Array.from({ length: bounds.endCol - bounds.startCol + 1 }, (_, i) => bounds.startCol + i);
+    }
+    if (params.startCell) {
+        const bounds = Range.between(params.startCell, params.endCell);
+        return Array.from({ length: bounds.endCol - bounds.startCol + 1 }, (_, i) => bounds.startCol + i);
+    }
+    return [];
+}
+export const excel_set_dimensions = defineTool({
+    name: "excel_set_dimensions",
+    description: "Adjust row heights and column widths by range, explicit rows/columns, or sheet defaults.",
+    inputSchema: setDimensionsInputSchema,
+    outputSchema: operationResultOutputShape,
+    handler: async (args) => {
+        try {
+            const { filePath, sheetName, rowHeight, columnWidth, defaultRowHeight, defaultColumnWidth } = args;
+            if (rowHeight === undefined &&
+                columnWidth === undefined &&
+                defaultRowHeight === undefined &&
+                defaultColumnWidth === undefined) {
+                throw new Error("Provide rowHeight, columnWidth, defaultRowHeight, and/or defaultColumnWidth");
+            }
+            const excel = await Excel.open(filePath);
+            const sheet = excel.sheet(sheetName);
+            const worksheet = sheet.raw;
+            const targetRows = collectTargetRows(args);
+            const targetColumns = collectTargetColumns(args);
+            if (rowHeight !== undefined) {
+                if (targetRows.length === 0) {
+                    throw new Error("rowHeight requires rows, range, or startCell");
+                }
+                for (const rowNumber of targetRows) {
+                    worksheet.getRow(rowNumber).height = rowHeight;
+                }
+            }
+            if (columnWidth !== undefined) {
+                if (targetColumns.length === 0) {
+                    throw new Error("columnWidth requires columns, range, or startCell");
+                }
+                for (const colNumber of targetColumns) {
+                    worksheet.getColumn(colNumber).width = columnWidth;
+                }
+            }
+            if (defaultRowHeight !== undefined) {
+                worksheet.properties.defaultRowHeight = defaultRowHeight;
+            }
+            if (defaultColumnWidth !== undefined) {
+                worksheet.properties.defaultColWidth = defaultColumnWidth;
+            }
+            await excel.save();
+            const parts = [];
+            if (rowHeight !== undefined) {
+                parts.push(`row height ${rowHeight} on rows ${targetRows.join(", ")}`);
+            }
+            if (columnWidth !== undefined) {
+                const labels = targetColumns.map((c) => Range.colToLetter(c));
+                parts.push(`column width ${columnWidth} on columns ${labels.join(", ")}`);
+            }
+            if (defaultRowHeight !== undefined) {
+                parts.push(`default row height ${defaultRowHeight}`);
+            }
+            if (defaultColumnWidth !== undefined) {
+                parts.push(`default column width ${defaultColumnWidth}`);
+            }
+            return {
+                success: true,
+                message: `Updated ${parts.join("; ")} on sheet '${worksheet.name}'`,
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ToolError("Failed to set dimensions: " + msg);
+        }
+    },
+});
+//# sourceMappingURL=excel_set_dimensions.js.map

package/dist/tools/excel_set_dimensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel_set_dimensions.js","sourceRoot":"","sources":["../../src/tools/excel_set_dimensions.ts"],"names":[],"mappings":"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"}

package/dist/tools/excel_set_sheet_visibility.d.ts

@@ -0,0 +1,2 @@
+export declare const excel_set_sheet_visibility: import("@achmadya-dev/mcp-core").RegisterableTool;
+//# sourceMappingURL=excel_set_sheet_visibility.d.ts.map

package/dist/tools/excel_set_sheet_visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel_set_sheet_visibility.d.ts","sourceRoot":"","sources":["../../src/tools/excel_set_sheet_visibility.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,0BAA0B,mDAqBrC,CAAC"}

package/dist/tools/excel_set_sheet_visibility.js

@@ -0,0 +1,39 @@
+import { defineTool, ToolError } from "@achmadya-dev/mcp-core";
+import { z } from "zod";
+import { Excel } from "../excel/excel.js";
+const filePathField = z.string().describe("Absolute path to the local Excel file (.xlsx)");
+const setSheetVisibilityInputSchema = z.object({
+    filePath: filePathField,
+    sheetName: z.string().describe("Worksheet to show or hide"),
+    state: z
+        .enum(["visible", "hidden", "veryHidden"])
+        .describe("visible = shown; hidden = hidden (user can unhide); veryHidden = hidden from Excel UI unhide menu"),
+});
+const operationResultOutputShape = z.object({
+    success: z.boolean(),
+    message: z.string(),
+});
+export const excel_set_sheet_visibility = defineTool({
+    name: "excel_set_sheet_visibility",
+    description: "Show, hide, or very-hide a worksheet (state: visible, hidden, veryHidden).",
+    inputSchema: setSheetVisibilityInputSchema,
+    outputSchema: operationResultOutputShape,
+    handler: async (args) => {
+        try {
+            const { filePath, sheetName, state } = args;
+            const excel = await Excel.open(filePath);
+            const sheet = excel.sheet(sheetName);
+            sheet.raw.state = state;
+            await excel.save();
+            return {
+                success: true,
+                message: `Sheet '${sheetName}' visibility set to '${state}'`,
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ToolError("Failed to set sheet visibility: " + msg);
+        }
+    },
+});
+//# sourceMappingURL=excel_set_sheet_visibility.js.map

package/dist/tools/excel_set_sheet_visibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel_set_sheet_visibility.js","sourceRoot":"","sources":["../../src/tools/excel_set_sheet_visibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC,CAAC;AAE3F,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,QAAQ,EAAE,aAAa;IACvB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC3D,KAAK,EAAE,CAAC;SACL,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;SACzC,QAAQ,CACP,mGAAmG,CACpG;CACJ,CAAC,CAAC;AAEH,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,UAAU,CAAC;IACnD,IAAI,EAAE,4BAA4B;IAClC,WAAW,EAAE,4EAA4E;IACzF,WAAW,EAAE,6BAA6B;IAC1C,YAAY,EAAE,0BAA0B;IACxC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;YAC5C,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACrC,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;YACxB,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,OAAO;gBACL,OAAO,EAAE,IAAa;gBACtB,OAAO,EAAE,UAAU,SAAS,wBAAwB,KAAK,GAAG;aAC7D,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,MAAM,IAAI,SAAS,CAAC,kCAAkC,GAAG,GAAG,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/excel_unmerge_cells.d.ts

@@ -0,0 +1,2 @@
+export declare const excel_unmerge_cells: import("@achmadya-dev/mcp-core").RegisterableTool;
+//# sourceMappingURL=excel_unmerge_cells.d.ts.map

package/dist/tools/excel_unmerge_cells.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel_unmerge_cells.d.ts","sourceRoot":"","sources":["../../src/tools/excel_unmerge_cells.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,mBAAmB,mDAqB9B,CAAC"}

package/dist/tools/excel_unmerge_cells.js

@@ -0,0 +1,42 @@
+import { defineTool, ToolError } from "@achmadya-dev/mcp-core";
+import { z } from "zod";
+import { Excel } from "../excel/excel.js";
+const filePathField = z.string().describe("Absolute path to the local Excel file (.xlsx)");
+const sheetNameOptional = z
+    .string()
+    .optional()
+    .describe("Name of the worksheet (defaults to the first sheet)");
+const unmergeCellsInputSchema = z.object({
+    filePath: filePathField,
+    sheetName: sheetNameOptional,
+    startCell: z.string(),
+    endCell: z.string(),
+});
+const operationResultOutputShape = z.object({
+    success: z.boolean(),
+    message: z.string(),
+});
+export const excel_unmerge_cells = defineTool({
+    name: "excel_unmerge_cells",
+    description: "Unmerge a previously merged range.",
+    inputSchema: unmergeCellsInputSchema,
+    outputSchema: operationResultOutputShape,
+    handler: async (args) => {
+        try {
+            const excel = await Excel.open(args.filePath);
+            const sheet = excel.sheet(args.sheetName);
+            const bounds = sheet.range(args.startCell, args.endCell);
+            sheet.raw.unMergeCells(bounds.startRow, bounds.startCol, bounds.endRow, bounds.endCol);
+            await excel.save();
+            return {
+                success: true,
+                message: `Unmerged cells ${args.startCell}:${args.endCell}`,
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ToolError("Failed to unmerge cells: " + msg);
+        }
+    },
+});
+//# sourceMappingURL=excel_unmerge_cells.js.map

package/dist/tools/excel_unmerge_cells.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel_unmerge_cells.js","sourceRoot":"","sources":["../../src/tools/excel_unmerge_cells.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC,CAAC;AAE3F,MAAM,iBAAiB,GAAG,CAAC;KACxB,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CAAC,qDAAqD,CAAC,CAAC;AAEnE,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,QAAQ,EAAE,aAAa;IACvB,SAAS,EAAE,iBAAiB;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;IAC5C,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,oCAAoC;IACjD,WAAW,EAAE,uBAAuB;IACpC,YAAY,EAAE,0BAA0B;IACxC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACzD,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YACvF,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,OAAO;gBACL,OAAO,EAAE,IAAa;gBACtB,OAAO,EAAE,kBAAkB,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE;aAC5D,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,MAAM,IAAI,SAAS,CAAC,2BAA2B,GAAG,GAAG,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/excel_write_range.d.ts

@@ -0,0 +1,2 @@
+export declare const excel_write_range: import("@achmadya-dev/mcp-core").RegisterableTool;
+//# sourceMappingURL=excel_write_range.d.ts.map

package/dist/tools/excel_write_range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel_write_range.d.ts","sourceRoot":"","sources":["../../src/tools/excel_write_range.ts"],"names":[],"mappings":"AAgGA,eAAO,MAAM,iBAAiB,mDAoF5B,CAAC"}

package/dist/tools/excel_write_range.js

@@ -0,0 +1,156 @@
+import { defineTool, ToolError } from "@achmadya-dev/mcp-core";
+import { z } from "zod";
+import { Cell } from "../excel/cell.js";
+import { Excel } from "../excel/excel.js";
+import { Range } from "../excel/range.js";
+const filePathField = z.string().describe("Absolute path to the local Excel file (.xlsx)");
+const sheetNameOptional = z
+    .string()
+    .optional()
+    .describe("Name of the worksheet (defaults to the first sheet)");
+const cellValueSchema = z.union([z.string(), z.number(), z.boolean(), z.null()]);
+const borderSideSchema = z
+    .object({
+    style: z.string().optional(),
+    color: z.string().optional(),
+})
+    .optional();
+const cellStyleSchema = z.object({
+    font: z
+        .object({
+        name: z.string().optional(),
+        size: z.number().optional(),
+        bold: z.boolean().optional(),
+        italic: z.boolean().optional(),
+        underline: z.boolean().optional(),
+        color: z.string().optional(),
+    })
+        .optional(),
+    fill: z
+        .object({
+        type: z.enum(["pattern", "gradient"]).optional(),
+        pattern: z.string().optional(),
+        fgColor: z.string().optional(),
+        bgColor: z.string().optional(),
+    })
+        .optional(),
+    alignment: z
+        .object({
+        horizontal: z.enum(["left", "center", "right", "justify", "distributed"]).optional(),
+        vertical: z.enum(["top", "middle", "bottom", "justify", "distributed"]).optional(),
+        wrapText: z.boolean().optional(),
+    })
+        .optional(),
+    border: z
+        .object({
+        top: borderSideSchema,
+        left: borderSideSchema,
+        bottom: borderSideSchema,
+        right: borderSideSchema,
+    })
+        .optional(),
+    numFmt: z.string().optional(),
+});
+const writeRangeInputSchema = z.object({
+    filePath: filePathField,
+    sheetName: sheetNameOptional,
+    newSheet: z
+        .boolean()
+        .optional()
+        .describe("Create a new sheet (blank if no values/data, or write initial data)"),
+    append: z
+        .boolean()
+        .optional()
+        .describe("Append rows to the bottom of the sheet instead of writing at startCell"),
+    range: z.string().optional(),
+    startCell: z
+        .string()
+        .optional()
+        .describe("Start cell (default A1); use for single-cell writes including formulas (=...)"),
+    values: z.array(z.array(cellValueSchema)).optional(),
+    data: z.array(z.record(z.string(), z.any())).optional(),
+    style: cellStyleSchema
+        .optional()
+        .describe("Optional style when writing a single cell via startCell + one value"),
+});
+const operationResultOutputShape = z.object({
+    success: z.boolean(),
+    message: z.string(),
+});
+function recordsToGrid(data) {
+    if (data.length === 0)
+        return [];
+    const keys = Object.keys(data[0]);
+    const grid = [keys];
+    for (const record of data) {
+        grid.push(keys.map((k) => record[k] ?? null));
+    }
+    return grid;
+}
+export const excel_write_range = defineTool({
+    name: "excel_write_range",
+    description: "Write data: values (2D), data (objects), append rows (append:true), create blank sheet (newSheet:true), single cell/formula (startCell + values), optional style for one cell.",
+    inputSchema: writeRangeInputSchema,
+    outputSchema: operationResultOutputShape,
+    handler: async (args) => {
+        try {
+            const { filePath, sheetName, newSheet = false, append = false, range, startCell = "A1", style, } = args;
+            let grid = args.values;
+            if (!grid && args.data) {
+                grid = recordsToGrid(args.data);
+            }
+            const excel = await Excel.open(filePath);
+            let sheet;
+            if (newSheet) {
+                if (!sheetName)
+                    throw new Error("sheetName is required when newSheet is true");
+                sheet = excel.addSheet(sheetName);
+                if (!grid || grid.length === 0) {
+                    await excel.save();
+                    return { success: true, message: `Sheet '${sheetName}' created in ${filePath}` };
+                }
+            }
+            else {
+                sheet = excel.sheet(sheetName);
+            }
+            const worksheet = sheet.raw;
+            if (!grid || grid.length === 0) {
+                throw new Error("values, data, or append rows are required unless newSheet creates a blank sheet");
+            }
+            if (append) {
+                for (const rowData of grid) {
+                    worksheet.addRow(rowData);
+                }
+                await excel.save();
+                return {
+                    success: true,
+                    message: `Appended ${grid.length} row(s) to sheet '${worksheet.name}'`,
+                };
+            }
+            const origin = range ? Range.parse(range).startRow : Range.parse(startCell).startRow;
+            const originCol = range ? Range.parse(range).startCol : Range.parse(startCell).startCol;
+            for (let r = 0; r < grid.length; r++) {
+                const row = grid[r];
+                for (let c = 0; c < row.length; c++) {
+                    const cell = worksheet.getCell(origin + r, originCol + c);
+                    Cell.set(cell, row[c]);
+                    if (style && grid.length === 1 && row.length === 1) {
+                        Cell.applyStyle(cell, style);
+                    }
+                }
+            }
+            await excel.save();
+            const targetRange = range ??
+                `${startCell}:${Range.address(origin + grid.length - 1, originCol + grid[0].length - 1)}`;
+            return {
+                success: true,
+                message: `Wrote ${grid.length} row(s) to sheet '${worksheet.name}' at ${targetRange}`,
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ToolError("Failed to write range: " + msg);
+        }
+    },
+});
+//# sourceMappingURL=excel_write_range.js.map

package/dist/tools/excel_write_range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel_write_range.js","sourceRoot":"","sources":["../../src/tools/excel_write_range.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@achmadya-dev/mcp-excel-query",
+  "version": "0.3.0",
+  "description": "Model Context Protocol (MCP) server for local Excel file (.xlsx) reading and manipulation",
+  "type": "module",
+  "author": "achmadya",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/achmadya-dev/mcp-excel-query.git"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "excel",
+    "exceljs",
+    "xlsx"
+  ],
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-excel-query": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@achmadya-dev/mcp-core": "^0.3.3",
+    "exceljs": "^4.4.0",
+    "zod": "4.3.6"
+  },
+  "devDependencies": {
+    "@jest/globals": "30.4.1",
+    "@types/jest": "30.0.0",
+    "@types/node": "22.10.0",
+    "jest": "30.4.2",
+    "ts-jest": "29.4.11",
+    "typescript": "5.7.2",
+    "@changesets/cli": "2.29.8"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "start": "node dist/index.js",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "publish-packages": "pnpm run build && changeset publish"
+  }
+}