numbersmcp 0.2.0 → 0.3.0

package/dist/index.js

@@ -26,6 +26,11 @@ import { mergeCells } from "./tools/mergeCells.js";
 import { unmergeCells } from "./tools/unmergeCells.js";
 import { renameTable } from "./tools/renameTable.js";
 import { setCellStyle } from "./tools/setCellStyle.js";
+import { clearRange } from "./tools/clearRange.js";
+import { transposeTable } from "./tools/transposeTable.js";
+import { createDocument } from "./tools/createDocument.js";
+import { getActiveSheet } from "./tools/getActiveSheet.js";
+import { resizeRowColumn } from "./tools/resizeRowColumn.js";
 const server = new McpServer({
     name: "numbersmcp",
     version: "0.1.0",
@@ -242,5 +247,46 @@ server.tool("set-cell-style", "Set visual styling properties on a cell (font, co
     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) }] };
 });
+server.tool("clear-range", "Clear all values in 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 clear in A1 notation, e.g. 'A1:C10'"),
+    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 clearRange(document, range, sheet, table);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("transpose-table", "Transpose rows and columns of a Numbers table", {
+    document: z.string().describe("Name of the open Numbers document"),
+    sheet: z.string().optional().describe("Sheet name (defaults to first sheet)"),
+    table: z.string().optional().describe("Table name (defaults to first table)"),
+}, async ({ document, sheet, table }) => {
+    const result = await transposeTable(document, sheet, table);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("create-document", "Create a new Numbers document, optionally saving it with a given name", {
+    name: z.string().optional().describe("Name for the new document (without extension). If provided, the document is saved to ~/Documents/<name>.numbers"),
+}, async ({ name }) => {
+    const result = await createDocument(name);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("get-active-sheet", "Get the name of the currently active sheet in a Numbers document", {
+    document: z.string().describe("Name of the open Numbers document"),
+}, async ({ document }) => {
+    const result = await getActiveSheet(document);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("resize-row-column", "Resize the height of a row or the width of a column in a Numbers table. At least one of row (with height) or column (with width) must be provided.", {
+    document: z.string().describe("Name of the open Numbers document"),
+    sheet: z.string().optional().describe("Sheet name (defaults to first sheet)"),
+    table: z.string().optional().describe("Table name (defaults to first table)"),
+    row: z.number().int().positive().optional().describe("Row number to resize (1-based)"),
+    column: z.string().optional().describe("Column letter to resize, e.g. 'B'"),
+    height: z.number().positive().optional().describe("New row height in points"),
+    width: z.number().positive().optional().describe("New column width in points"),
+}, async ({ document, sheet, table, row, column, height, width }) => {
+    const result = await resizeRowColumn(document, sheet, table, row, column, height, width);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/dist/tools/clearRange.d.ts

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

package/dist/tools/clearRange.js

@@ -0,0 +1,15 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+export async function clearRange(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}"
+    clear range "${rangeEsc}"
+  end tell
+end tell`;
+    await runAppleScript(script);
+    return { success: true, range };
+}

package/dist/tools/createDocument.d.ts

@@ -0,0 +1,3 @@
+export declare function createDocument(name?: string): Promise<{
+    name: string;
+}>;

package/dist/tools/createDocument.js

@@ -0,0 +1,26 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+import * as os from "os";
+import * as path from "path";
+export async function createDocument(name) {
+    let script;
+    if (name) {
+        const nameEsc = escapeForAppleScript(name);
+        const savePath = path.join(os.homedir(), "Documents", `${name}.numbers`);
+        const savePathEsc = escapeForAppleScript(savePath);
+        script = `
+tell application "Numbers"
+  set newDoc to make new document
+  save newDoc in POSIX file "${savePathEsc}"
+  return name of newDoc
+end tell`;
+    }
+    else {
+        script = `
+tell application "Numbers"
+  set newDoc to make new document
+  return name of newDoc
+end tell`;
+    }
+    const result = await runAppleScript(script);
+    return { name: result.trim() };
+}

package/dist/tools/getActiveSheet.d.ts

@@ -0,0 +1,3 @@
+export declare function getActiveSheet(document: string): Promise<{
+    name: string;
+}>;

package/dist/tools/getActiveSheet.js

@@ -0,0 +1,13 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+export async function getActiveSheet(document) {
+    const docEsc = escapeForAppleScript(document);
+    const script = `
+tell application "Numbers"
+  tell document "${docEsc}"
+    set s to active sheet
+    return name of s
+  end tell
+end tell`;
+    const result = await runAppleScript(script);
+    return { name: result.trim() };
+}

package/dist/tools/resizeRowColumn.d.ts

@@ -0,0 +1,8 @@
+export declare function resizeRowColumn(document: string, sheet?: string, table?: string, row?: number, column?: string, height?: number, width?: number): Promise<{
+    success: boolean;
+    changes: {
+        type: string;
+        index: number | string;
+        size: number;
+    }[];
+}>;

package/dist/tools/resizeRowColumn.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 resizeRowColumn(document, sheet, table, row, column, height, width) {
+    const docEsc = escapeForAppleScript(document);
+    const tableRef = table ? `table "${escapeForAppleScript(table)}"` : "table 1";
+    const sheetRef = sheet ? `sheet "${escapeForAppleScript(sheet)}"` : "sheet 1";
+    const changes = [];
+    const lines = [];
+    if (row !== undefined && height !== undefined) {
+        lines.push(`    set height of row ${row} to ${height}`);
+        changes.push({ type: "row", index: row, size: height });
+    }
+    if (column !== undefined && width !== undefined) {
+        const colNum = colLetterToNum(column);
+        lines.push(`    set width of column ${colNum} to ${width}`);
+        changes.push({ type: "column", index: column, size: width });
+    }
+    const script = `
+tell application "Numbers"
+  tell ${tableRef} of ${sheetRef} of document "${docEsc}"
+${lines.join("\n")}
+  end tell
+end tell`;
+    await runAppleScript(script);
+    return { success: true, changes };
+}

package/dist/tools/transposeTable.d.ts

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

package/dist/tools/transposeTable.js

@@ -0,0 +1,14 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+export async function transposeTable(document, 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}"
+    transpose
+  end tell
+end tell`;
+    await runAppleScript(script);
+    return { success: true, document, sheet, table };
+}

package/package.json

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