numbersmcp 0.1.1 → 0.2.0

package/dist/index.js

@@ -11,6 +11,21 @@ import { addRow } from "./tools/addRow.js";
 import { readTable } from "./tools/readTable.js";
 import { getFormula } from "./tools/getFormula.js";
 import { setFormula } from "./tools/setFormula.js";
+import { addColumn } from "./tools/addColumn.js";
+import { deleteColumn } from "./tools/deleteColumn.js";
+import { deleteRow } from "./tools/deleteRow.js";
+import { addSheet } from "./tools/addSheet.js";
+import { deleteSheet } from "./tools/deleteSheet.js";
+import { renameSheet } from "./tools/renameSheet.js";
+import { addTable } from "./tools/addTable.js";
+import { deleteTable } from "./tools/deleteTable.js";
+import { setCellFormat } from "./tools/setCellFormat.js";
+import { sortTable } from "./tools/sortTable.js";
+import { exportDocument } from "./tools/exportDocument.js";
+import { mergeCells } from "./tools/mergeCells.js";
+import { unmergeCells } from "./tools/unmergeCells.js";
+import { renameTable } from "./tools/renameTable.js";
+import { setCellStyle } from "./tools/setCellStyle.js";
 const server = new McpServer({
     name: "numbersmcp",
     version: "0.1.0",
@@ -91,5 +106,141 @@ server.tool("set-formula", "Set a formula on a specific cell in a Numbers table
     const result = await setFormula(document, cell, formula, sheet, table);
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
 });
+server.tool("add-column", "Add a new column to a Numbers table", {
+    document: z.string().describe("Name of the open Numbers document"),
+    afterColumn: z.string().optional().describe("Column letter after which to insert (e.g. 'C'). Defaults to last column."),
+    sheet: z.string().optional().describe("Sheet name (defaults to first sheet)"),
+    table: z.string().optional().describe("Table name (defaults to first table)"),
+}, async ({ document, afterColumn, sheet, table }) => {
+    const result = await addColumn(document, afterColumn, sheet, table);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("delete-column", "Delete a column from a Numbers table", {
+    document: z.string().describe("Name of the open Numbers document"),
+    column: z.string().describe("Column letter to delete (e.g. 'C')"),
+    sheet: z.string().optional().describe("Sheet name (defaults to first sheet)"),
+    table: z.string().optional().describe("Table name (defaults to first table)"),
+}, async ({ document, column, sheet, table }) => {
+    const result = await deleteColumn(document, column, sheet, table);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("delete-row", "Delete a row from a Numbers table", {
+    document: z.string().describe("Name of the open Numbers document"),
+    row: z.number().int().positive().describe("Row number to delete"),
+    sheet: z.string().optional().describe("Sheet name (defaults to first sheet)"),
+    table: z.string().optional().describe("Table name (defaults to first table)"),
+}, async ({ document, row, sheet, table }) => {
+    const result = await deleteRow(document, row, sheet, table);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("add-sheet", "Add a new sheet to a Numbers document", {
+    document: z.string().describe("Name of the open Numbers document"),
+    name: z.string().optional().describe("Name for the new sheet"),
+}, async ({ document, name }) => {
+    const result = await addSheet(document, name);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("delete-sheet", "Delete a sheet from a Numbers document", {
+    document: z.string().describe("Name of the open Numbers document"),
+    sheet: z.string().describe("Name of the sheet to delete"),
+}, async ({ document, sheet }) => {
+    const result = await deleteSheet(document, sheet);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("rename-sheet", "Rename a sheet in a Numbers document", {
+    document: z.string().describe("Name of the open Numbers document"),
+    sheet: z.string().describe("Current name of the sheet"),
+    newName: z.string().describe("New name for the sheet"),
+}, async ({ document, sheet, newName }) => {
+    const result = await renameSheet(document, sheet, newName);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("add-table", "Add a new table to a sheet in a Numbers document", {
+    document: z.string().describe("Name of the open Numbers document"),
+    sheet: z.string().optional().describe("Sheet name (defaults to first sheet)"),
+    name: z.string().optional().describe("Name for the new table"),
+}, async ({ document, sheet, name }) => {
+    const result = await addTable(document, sheet, name);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("delete-table", "Delete a table from a sheet in a Numbers document", {
+    document: z.string().describe("Name of the open Numbers document"),
+    table: z.string().describe("Name of the table to delete"),
+    sheet: z.string().optional().describe("Sheet name (defaults to first sheet)"),
+}, async ({ document, table, sheet }) => {
+    const result = await deleteTable(document, table, sheet);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("set-cell-format", "Set the format of a cell (number, currency, percentage, date, text, etc.)", {
+    document: z.string().describe("Name of the open Numbers document"),
+    cell: z.string().describe("Cell reference in A1 notation, e.g. 'B3'"),
+    format: z.enum(["automatic", "number", "currency", "percentage", "date", "date-and-time", "duration", "checkbox", "star-rating", "text", "fraction", "scientific", "numeral-system"]).describe("Cell format type"),
+    sheet: z.string().optional().describe("Sheet name (defaults to first sheet)"),
+    table: z.string().optional().describe("Table name (defaults to first table)"),
+}, async ({ document, cell, format, sheet, table }) => {
+    const result = await setCellFormat(document, cell, format, sheet, table);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("sort-table", "Sort a Numbers table by a column", {
+    document: z.string().describe("Name of the open Numbers document"),
+    column: z.string().describe("Column letter to sort by, e.g. 'B'"),
+    direction: z.enum(["ascending", "descending"]).describe("Sort direction"),
+    sheet: z.string().optional().describe("Sheet name (defaults to first sheet)"),
+    table: z.string().optional().describe("Table name (defaults to first table)"),
+}, async ({ document, column, direction, sheet, table }) => {
+    const result = await sortTable(document, column, direction, sheet, table);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("export-document", "Export a Numbers document to PDF, Excel, or CSV format", {
+    document: z.string().describe("Name of the open Numbers document"),
+    path: z.string().describe("Full output file path, e.g. '/Users/me/output.xlsx'"),
+    format: z.enum(["pdf", "excel", "csv"]).describe("Export format"),
+}, async ({ document, path, format }) => {
+    const result = await exportDocument(document, path, format);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("merge-cells", "Merge a range of cells in a Numbers table", {
+    document: z.string().describe("Name of the open Numbers document"),
+    range: z.string().describe("Cell range to merge, e.g. 'A1:C1'"),
+    sheet: z.string().optional().describe("Sheet name (defaults to first sheet)"),
+    table: z.string().optional().describe("Table name (defaults to first table)"),
+}, async ({ document, range, sheet, table }) => {
+    const result = await mergeCells(document, range, sheet, table);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("unmerge-cells", "Unmerge a range of cells in a Numbers table", {
+    document: z.string().describe("Name of the open Numbers document"),
+    range: z.string().describe("Cell range to unmerge, e.g. 'A1:C1'"),
+    sheet: z.string().optional().describe("Sheet name (defaults to first sheet)"),
+    table: z.string().optional().describe("Table name (defaults to first table)"),
+}, async ({ document, range, sheet, table }) => {
+    const result = await unmergeCells(document, range, sheet, table);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("rename-table", "Rename a table in a Numbers document", {
+    document: z.string().describe("Name of the open Numbers document"),
+    table: z.string().describe("Current name of the table"),
+    newName: z.string().describe("New name for the table"),
+    sheet: z.string().optional().describe("Sheet name (defaults to first sheet)"),
+}, async ({ document, table, newName, sheet }) => {
+    const result = await renameTable(document, table, newName, sheet);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("set-cell-style", "Set visual styling properties on a cell (font, color, bold, italic, alignment, background)", {
+    document: z.string().describe("Name of the open Numbers document"),
+    cell: z.string().describe("Cell reference in A1 notation, e.g. 'B3'"),
+    sheet: z.string().optional().describe("Sheet name (defaults to first sheet)"),
+    table: z.string().optional().describe("Table name (defaults to first table)"),
+    fontName: z.string().optional().describe("Font name, e.g. 'Helvetica'"),
+    fontSize: z.number().optional().describe("Font size in points"),
+    textColor: z.string().optional().describe("Text color as RGB hex, e.g. '#FF0000'"),
+    backgroundColor: z.string().optional().describe("Background color as RGB hex, e.g. '#0000FF'"),
+    bold: z.boolean().optional().describe("Set bold"),
+    italic: z.boolean().optional().describe("Set italic"),
+    alignment: z.enum(["left", "center", "right", "justify", "auto"]).optional().describe("Horizontal text alignment"),
+}, async ({ document, cell, sheet, table, fontName, fontSize, textColor, backgroundColor, bold, italic, alignment }) => {
+    const result = await setCellStyle(document, cell, sheet, table, fontName, fontSize, textColor, backgroundColor, bold, italic, alignment);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/dist/tools/addColumn.d.ts

@@ -0,0 +1,7 @@
+export declare function addColumn(document: string, afterColumn?: string, sheet?: string, table?: string): Promise<{
+    success: boolean;
+    document: string;
+    sheet: string;
+    table: string;
+    afterColumn: string;
+}>;

package/dist/tools/addColumn.js

@@ -0,0 +1,44 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+function colLetterToNum(col) {
+    let n = 0;
+    for (const ch of col.toUpperCase()) {
+        n = n * 26 + (ch.charCodeAt(0) - 64);
+    }
+    return n;
+}
+export async function addColumn(document, afterColumn, sheet, table) {
+    const docEsc = escapeForAppleScript(document);
+    const tableRef = table
+        ? `table "${escapeForAppleScript(table)}"`
+        : "table 1";
+    const sheetRef = sheet
+        ? `sheet "${escapeForAppleScript(sheet)}"`
+        : "sheet 1";
+    let script;
+    if (afterColumn) {
+        const colNum = colLetterToNum(afterColumn);
+        script = `
+tell application "Numbers"
+  tell ${tableRef} of ${sheetRef} of document "${docEsc}"
+    add column after column ${colNum}
+  end tell
+end tell`;
+    }
+    else {
+        script = `
+tell application "Numbers"
+  tell ${tableRef} of ${sheetRef} of document "${docEsc}"
+    set colCount to column count
+    add column after column colCount
+  end tell
+end tell`;
+    }
+    await runAppleScript(script);
+    return {
+        success: true,
+        document,
+        sheet: sheet ?? "sheet 1",
+        table: table ?? "table 1",
+        afterColumn: afterColumn ?? "last",
+    };
+}

package/dist/tools/addSheet.d.ts

@@ -0,0 +1,5 @@
+export declare function addSheet(document: string, name?: string): Promise<{
+    success: boolean;
+    document: string;
+    name: string | null;
+}>;

package/dist/tools/addSheet.js

@@ -0,0 +1,28 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+export async function addSheet(document, name) {
+    const docEsc = escapeForAppleScript(document);
+    let script;
+    if (name) {
+        const nameEsc = escapeForAppleScript(name);
+        script = `
+tell application "Numbers"
+  tell document "${docEsc}"
+    make new sheet with properties {name:"${nameEsc}"}
+  end tell
+end tell`;
+    }
+    else {
+        script = `
+tell application "Numbers"
+  tell document "${docEsc}"
+    make new sheet
+  end tell
+end tell`;
+    }
+    await runAppleScript(script);
+    return {
+        success: true,
+        document,
+        name: name ?? null,
+    };
+}

package/dist/tools/addTable.d.ts

@@ -0,0 +1,6 @@
+export declare function addTable(document: string, sheet?: string, name?: string): Promise<{
+    success: boolean;
+    document: string;
+    sheet: string;
+    name: string | null;
+}>;

package/dist/tools/addTable.js

@@ -0,0 +1,32 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+export async function addTable(document, sheet, name) {
+    const docEsc = escapeForAppleScript(document);
+    const sheetRef = sheet
+        ? `sheet "${escapeForAppleScript(sheet)}"`
+        : "sheet 1";
+    let script;
+    if (name) {
+        const nameEsc = escapeForAppleScript(name);
+        script = `
+tell application "Numbers"
+  tell ${sheetRef} of document "${docEsc}"
+    make new table with properties {name:"${nameEsc}"}
+  end tell
+end tell`;
+    }
+    else {
+        script = `
+tell application "Numbers"
+  tell ${sheetRef} of document "${docEsc}"
+    make new table
+  end tell
+end tell`;
+    }
+    await runAppleScript(script);
+    return {
+        success: true,
+        document,
+        sheet: sheet ?? "sheet 1",
+        name: name ?? null,
+    };
+}

package/dist/tools/deleteColumn.d.ts

@@ -0,0 +1,7 @@
+export declare function deleteColumn(document: string, column: string, sheet?: string, table?: string): Promise<{
+    success: boolean;
+    document: string;
+    sheet: string;
+    table: string;
+    column: string;
+}>;

package/dist/tools/deleteColumn.js

@@ -0,0 +1,32 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+function colLetterToNum(col) {
+    let n = 0;
+    for (const ch of col.toUpperCase()) {
+        n = n * 26 + (ch.charCodeAt(0) - 64);
+    }
+    return n;
+}
+export async function deleteColumn(document, column, sheet, table) {
+    const docEsc = escapeForAppleScript(document);
+    const colNum = colLetterToNum(column);
+    const tableRef = table
+        ? `table "${escapeForAppleScript(table)}"`
+        : "table 1";
+    const sheetRef = sheet
+        ? `sheet "${escapeForAppleScript(sheet)}"`
+        : "sheet 1";
+    const script = `
+tell application "Numbers"
+  tell ${tableRef} of ${sheetRef} of document "${docEsc}"
+    delete column ${colNum}
+  end tell
+end tell`;
+    await runAppleScript(script);
+    return {
+        success: true,
+        document,
+        sheet: sheet ?? "sheet 1",
+        table: table ?? "table 1",
+        column,
+    };
+}

package/dist/tools/deleteRow.d.ts

@@ -0,0 +1,7 @@
+export declare function deleteRow(document: string, row: number, sheet?: string, table?: string): Promise<{
+    success: boolean;
+    document: string;
+    sheet: string;
+    table: string;
+    row: number;
+}>;

package/dist/tools/deleteRow.js

@@ -0,0 +1,24 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+export async function deleteRow(document, row, sheet, table) {
+    const docEsc = escapeForAppleScript(document);
+    const tableRef = table
+        ? `table "${escapeForAppleScript(table)}"`
+        : "table 1";
+    const sheetRef = sheet
+        ? `sheet "${escapeForAppleScript(sheet)}"`
+        : "sheet 1";
+    const script = `
+tell application "Numbers"
+  tell ${tableRef} of ${sheetRef} of document "${docEsc}"
+    delete row ${row}
+  end tell
+end tell`;
+    await runAppleScript(script);
+    return {
+        success: true,
+        document,
+        sheet: sheet ?? "sheet 1",
+        table: table ?? "table 1",
+        row,
+    };
+}

package/dist/tools/deleteSheet.d.ts

@@ -0,0 +1,5 @@
+export declare function deleteSheet(document: string, sheet: string): Promise<{
+    success: boolean;
+    document: string;
+    sheet: string;
+}>;

package/dist/tools/deleteSheet.js

@@ -0,0 +1,17 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+export async function deleteSheet(document, sheet) {
+    const docEsc = escapeForAppleScript(document);
+    const sheetEsc = escapeForAppleScript(sheet);
+    const script = `
+tell application "Numbers"
+  tell document "${docEsc}"
+    delete sheet "${sheetEsc}"
+  end tell
+end tell`;
+    await runAppleScript(script);
+    return {
+        success: true,
+        document,
+        sheet,
+    };
+}

package/dist/tools/deleteTable.d.ts

@@ -0,0 +1,6 @@
+export declare function deleteTable(document: string, table: string, sheet?: string): Promise<{
+    success: boolean;
+    document: string;
+    sheet: string;
+    table: string;
+}>;

package/dist/tools/deleteTable.js

@@ -0,0 +1,21 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+export async function deleteTable(document, table, sheet) {
+    const docEsc = escapeForAppleScript(document);
+    const tableEsc = escapeForAppleScript(table);
+    const sheetRef = sheet
+        ? `sheet "${escapeForAppleScript(sheet)}"`
+        : "sheet 1";
+    const script = `
+tell application "Numbers"
+  tell ${sheetRef} of document "${docEsc}"
+    delete table "${tableEsc}"
+  end tell
+end tell`;
+    await runAppleScript(script);
+    return {
+        success: true,
+        document,
+        sheet: sheet ?? "sheet 1",
+        table,
+    };
+}

package/dist/tools/exportDocument.d.ts

@@ -0,0 +1,6 @@
+export declare function exportDocument(document: string, path: string, format: "pdf" | "excel" | "csv"): Promise<{
+    success: boolean;
+    document: string;
+    path: string;
+    format: "pdf" | "excel" | "csv";
+}>;

package/dist/tools/exportDocument.js

@@ -0,0 +1,17 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+const FORMAT_MAP = {
+    pdf: "PDF",
+    excel: "Microsoft Excel",
+    csv: "CSV",
+};
+export async function exportDocument(document, path, format) {
+    const docEsc = escapeForAppleScript(document);
+    const pathEsc = escapeForAppleScript(path);
+    const asFormat = FORMAT_MAP[format];
+    const script = `
+tell application "Numbers"
+  export document "${docEsc}" to POSIX file "${pathEsc}" as ${asFormat}
+end tell`;
+    await runAppleScript(script);
+    return { success: true, document, path, format };
+}

package/dist/tools/mergeCells.d.ts

@@ -0,0 +1,5 @@
+export declare function mergeCells(document: string, range: string, sheet?: string, table?: string): Promise<{
+    success: boolean;
+    document: string;
+    range: string;
+}>;

package/dist/tools/mergeCells.js

@@ -0,0 +1,15 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+export async function mergeCells(document, range, sheet, table) {
+    const docEsc = escapeForAppleScript(document);
+    const tableRef = table ? `table "${escapeForAppleScript(table)}"` : "table 1";
+    const sheetRef = sheet ? `sheet "${escapeForAppleScript(sheet)}"` : "sheet 1";
+    const rangeEsc = escapeForAppleScript(range);
+    const script = `
+tell application "Numbers"
+  tell ${tableRef} of ${sheetRef} of document "${docEsc}"
+    merge range "${rangeEsc}"
+  end tell
+end tell`;
+    await runAppleScript(script);
+    return { success: true, document, range };
+}

package/dist/tools/renameSheet.d.ts

@@ -0,0 +1,6 @@
+export declare function renameSheet(document: string, sheet: string, newName: string): Promise<{
+    success: boolean;
+    document: string;
+    sheet: string;
+    newName: string;
+}>;

package/dist/tools/renameSheet.js

@@ -0,0 +1,17 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+export async function renameSheet(document, sheet, newName) {
+    const docEsc = escapeForAppleScript(document);
+    const sheetEsc = escapeForAppleScript(sheet);
+    const newNameEsc = escapeForAppleScript(newName);
+    const script = `
+tell application "Numbers"
+  set name of sheet "${sheetEsc}" of document "${docEsc}" to "${newNameEsc}"
+end tell`;
+    await runAppleScript(script);
+    return {
+        success: true,
+        document,
+        sheet,
+        newName,
+    };
+}

package/dist/tools/renameTable.d.ts

@@ -0,0 +1,6 @@
+export declare function renameTable(document: string, table: string, newName: string, sheet?: string): Promise<{
+    success: boolean;
+    document: string;
+    oldName: string;
+    newName: string;
+}>;

package/dist/tools/renameTable.js

@@ -0,0 +1,13 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+export async function renameTable(document, table, newName, sheet) {
+    const docEsc = escapeForAppleScript(document);
+    const tableEsc = escapeForAppleScript(table);
+    const newNameEsc = escapeForAppleScript(newName);
+    const sheetRef = sheet ? `sheet "${escapeForAppleScript(sheet)}"` : "sheet 1";
+    const script = `
+tell application "Numbers"
+  set name of table "${tableEsc}" of ${sheetRef} of document "${docEsc}" to "${newNameEsc}"
+end tell`;
+    await runAppleScript(script);
+    return { success: true, document, oldName: table, newName };
+}

package/dist/tools/setCellFormat.d.ts

@@ -0,0 +1,8 @@
+export declare function setCellFormat(document: string, cell: string, format: string, sheet?: string, table?: string): Promise<{
+    success: boolean;
+    document: string;
+    cell: string;
+    format: string;
+    sheet: string;
+    table: string;
+}>;

package/dist/tools/setCellFormat.js

@@ -0,0 +1,53 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+const FORMAT_MAP = {
+    "automatic": "automatic",
+    "number": "number",
+    "currency": "currency",
+    "percentage": "percentage",
+    "date": "date and time",
+    "date-and-time": "date and time",
+    "duration": "duration",
+    "checkbox": "checkbox",
+    "star-rating": "star rating",
+    "text": "text",
+    "fraction": "fraction",
+    "scientific": "scientific",
+    "numeral-system": "numeral system",
+};
+function parseCellRef(ref) {
+    const match = ref.match(/^([A-Z]+)(\d+)$/i);
+    if (!match)
+        throw new Error(`Invalid cell reference: ${ref}`);
+    const letters = match[1].toUpperCase();
+    let col = 0;
+    for (let i = 0; i < letters.length; i++) {
+        col = col * 26 + (letters.charCodeAt(i) - 64);
+    }
+    return { row: parseInt(match[2], 10), col };
+}
+export async function setCellFormat(document, cell, format, sheet, table) {
+    const docEsc = escapeForAppleScript(document);
+    const tableRef = table
+        ? `table "${escapeForAppleScript(table)}"`
+        : "table 1";
+    const sheetRef = sheet
+        ? `sheet "${escapeForAppleScript(sheet)}"`
+        : "sheet 1";
+    const { row, col } = parseCellRef(cell);
+    const resolved = FORMAT_MAP[format.toLowerCase()] ?? format;
+    const script = `
+tell application "Numbers"
+  tell ${tableRef} of ${sheetRef} of document "${docEsc}"
+    set format of cell ${col} of row ${row} to ${resolved}
+  end tell
+end tell`;
+    await runAppleScript(script);
+    return {
+        success: true,
+        document,
+        cell,
+        format: resolved,
+        sheet: sheet ?? "sheet 1",
+        table: table ?? "table 1",
+    };
+}

package/dist/tools/setCellStyle.d.ts

@@ -0,0 +1,5 @@
+export declare function setCellStyle(document: string, cell: string, sheet?: string, table?: string, fontName?: string, fontSize?: number, textColor?: string, backgroundColor?: string, bold?: boolean, italic?: boolean, alignment?: "left" | "center" | "right" | "justify" | "auto"): Promise<{
+    success: boolean;
+    cell: string;
+    appliedStyles: string[];
+}>;

package/dist/tools/setCellStyle.js

@@ -0,0 +1,64 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+import { parseCellRef } from "./readRange.js";
+function hexToAppleScriptRgb(hex) {
+    const h = hex.replace(/^#/, "");
+    const r = Math.round((parseInt(h.slice(0, 2), 16) / 255) * 65535);
+    const g = Math.round((parseInt(h.slice(2, 4), 16) / 255) * 65535);
+    const b = Math.round((parseInt(h.slice(4, 6), 16) / 255) * 65535);
+    return `{${r}, ${g}, ${b}}`;
+}
+const ALIGNMENT_MAP = {
+    left: "left",
+    center: "center",
+    right: "right",
+    justify: "justify",
+    auto: "auto",
+};
+export async function setCellStyle(document, cell, sheet, table, fontName, fontSize, textColor, backgroundColor, bold, italic, alignment) {
+    const docEsc = escapeForAppleScript(document);
+    const tableRef = table ? `table "${escapeForAppleScript(table)}"` : "table 1";
+    const sheetRef = sheet ? `sheet "${escapeForAppleScript(sheet)}"` : "sheet 1";
+    const { row, col } = parseCellRef(cell);
+    const styleLines = [];
+    const appliedStyles = [];
+    if (fontName !== undefined) {
+        styleLines.push(`set font name of theCell to "${escapeForAppleScript(fontName)}"`);
+        appliedStyles.push("fontName");
+    }
+    if (fontSize !== undefined) {
+        styleLines.push(`set font size of theCell to ${fontSize}`);
+        appliedStyles.push("fontSize");
+    }
+    if (textColor !== undefined) {
+        styleLines.push(`set text color of theCell to ${hexToAppleScriptRgb(textColor)}`);
+        appliedStyles.push("textColor");
+    }
+    if (backgroundColor !== undefined) {
+        styleLines.push(`set background color of theCell to ${hexToAppleScriptRgb(backgroundColor)}`);
+        appliedStyles.push("backgroundColor");
+    }
+    if (bold !== undefined) {
+        styleLines.push(`set bold of theCell to ${bold}`);
+        appliedStyles.push("bold");
+    }
+    if (italic !== undefined) {
+        styleLines.push(`set italic of theCell to ${italic}`);
+        appliedStyles.push("italic");
+    }
+    if (alignment !== undefined) {
+        styleLines.push(`set alignment of theCell to ${ALIGNMENT_MAP[alignment]}`);
+        appliedStyles.push("alignment");
+    }
+    if (styleLines.length === 0) {
+        return { success: true, cell, appliedStyles: [] };
+    }
+    const script = `
+tell application "Numbers"
+  tell ${tableRef} of ${sheetRef} of document "${docEsc}"
+    set theCell to cell ${col} of row ${row}
+    ${styleLines.join("\n    ")}
+  end tell
+end tell`;
+    await runAppleScript(script);
+    return { success: true, cell, appliedStyles };
+}

package/dist/tools/sortTable.d.ts

@@ -0,0 +1,6 @@
+export declare function sortTable(document: string, column: string, direction: "ascending" | "descending", sheet?: string, table?: string): Promise<{
+    success: boolean;
+    document: string;
+    column: string;
+    direction: "ascending" | "descending";
+}>;

package/dist/tools/sortTable.js

@@ -0,0 +1,22 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+function colLetterToNum(col) {
+    let n = 0;
+    for (const ch of col.toUpperCase()) {
+        n = n * 26 + (ch.charCodeAt(0) - 64);
+    }
+    return n;
+}
+export async function sortTable(document, column, direction, sheet, table) {
+    const docEsc = escapeForAppleScript(document);
+    const tableRef = table ? `table "${escapeForAppleScript(table)}"` : "table 1";
+    const sheetRef = sheet ? `sheet "${escapeForAppleScript(sheet)}"` : "sheet 1";
+    const colNum = colLetterToNum(column);
+    const script = `
+tell application "Numbers"
+  tell ${tableRef} of ${sheetRef} of document "${docEsc}"
+    sort by column ${colNum} direction ${direction}
+  end tell
+end tell`;
+    await runAppleScript(script);
+    return { success: true, document, column, direction };
+}

package/dist/tools/unmergeCells.d.ts

@@ -0,0 +1,5 @@
+export declare function unmergeCells(document: string, range: string, sheet?: string, table?: string): Promise<{
+    success: boolean;
+    document: string;
+    range: string;
+}>;

package/dist/tools/unmergeCells.js

@@ -0,0 +1,15 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+export async function unmergeCells(document, range, sheet, table) {
+    const docEsc = escapeForAppleScript(document);
+    const tableRef = table ? `table "${escapeForAppleScript(table)}"` : "table 1";
+    const sheetRef = sheet ? `sheet "${escapeForAppleScript(sheet)}"` : "sheet 1";
+    const rangeEsc = escapeForAppleScript(range);
+    const script = `
+tell application "Numbers"
+  tell ${tableRef} of ${sheetRef} of document "${docEsc}"
+    unmerge range "${rangeEsc}"
+  end tell
+end tell`;
+    await runAppleScript(script);
+    return { success: true, document, range };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "numbersmcp",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "MCP server for macOS Numbers.app — spreadsheet access via AppleScript",
   "mcpName": "io.github.aernouddekker/numbersmcp",
   "type": "module",