iwork-mcp 0.1.2 → 0.2.0

package/README.md

@@ -18,12 +18,20 @@ Ask Claude to build spreadsheets, write documents, and create presentations —
 
 ## Install
 
+### Claude Desktop
+
 ```bash
 npx iwork-mcp install
 ```
 
 Then restart Claude Desktop (Cmd+Q and reopen). Done.
 
+### Claude Code
+
+```bash
+claude mcp add iwork -- npx -y iwork-mcp
+```
+
 ### Requirements
 
 - macOS with Numbers, Pages, or Keynote installed (free on every Mac)

package/dist/tools/numbers.js

@@ -243,6 +243,61 @@ export function registerNumbersTools(server) {
       }
       return JSON.stringify(results);
     `, { documentName, writes, sheetName: sheetName ?? null, tableName: tableName ?? null })));
+    server.tool("numbers_write_table", "Bulk write an entire table of data in a single operation. Much faster than writing cells individually. Resizes the table to fit the data automatically.", {
+        documentName: z.string().describe("Name of the open document"),
+        data: z.array(z.array(z.union([z.string(), z.number(), z.boolean(), z.null()])))
+            .describe("2D array of data — first row can be headers. Null cells are skipped."),
+        startCell: z.string().optional().describe("Top-left cell to start writing from (default: 'A1')"),
+        sheetName: z.string().optional().describe("Sheet name (defaults to first sheet)"),
+        tableName: z.string().optional().describe("Table name (defaults to first table)"),
+        resizeToFit: z.boolean().optional().describe("Resize table to fit data (default: true)"),
+    }, async ({ documentName, data, startCell, sheetName, tableName, resizeToFit }) => handleJXA(() => runJXA(`
+      const app = Application("Numbers");
+      const doc = app.documents.byName(params.documentName);
+      const sheet = params.sheetName ? doc.sheets.byName(params.sheetName) : doc.sheets[0];
+      const table = params.tableName ? sheet.tables.byName(params.tableName) : sheet.tables[0];
+
+      // Parse start cell (e.g. "B3" -> col=1, row=2)
+      const cellRef = (params.startCell || "A1").toUpperCase();
+      const colMatch = cellRef.match(/^([A-Z]+)/);
+      const rowMatch = cellRef.match(/(\\d+)$/);
+      let startCol = 0;
+      if (colMatch) {
+        for (let i = 0; i < colMatch[1].length; i++) {
+          startCol = startCol * 26 + (colMatch[1].charCodeAt(i) - 64);
+        }
+        startCol -= 1;
+      }
+      const startRow = rowMatch ? parseInt(rowMatch[1]) - 1 : 0;
+
+      const dataRows = params.data.length;
+      const dataCols = Math.max(...params.data.map(r => r.length));
+      const needRows = startRow + dataRows;
+      const needCols = startCol + dataCols;
+
+      // Resize table if needed
+      if (params.resizeToFit !== false) {
+        while (table.rowCount() < needRows) {
+          table.rows.push(app.Row());
+        }
+        while (table.columnCount() < needCols) {
+          table.columns.push(app.Column());
+        }
+      }
+
+      const colCount = table.columnCount();
+      let cellsWritten = 0;
+      for (let r = 0; r < dataRows; r++) {
+        for (let c = 0; c < params.data[r].length; c++) {
+          const val = params.data[r][c];
+          if (val !== null) {
+            table.cells[(startRow + r) * colCount + (startCol + c)].value = val;
+            cellsWritten++;
+          }
+        }
+      }
+      return JSON.stringify({ cellsWritten: cellsWritten, rows: dataRows, columns: dataCols });
+    `, { documentName, data, startCell: startCell ?? null, sheetName: sheetName ?? null, tableName: tableName ?? null, resizeToFit: resizeToFit ?? true })));
     server.tool("numbers_set_formula", "Set a formula on a cell (e.g. '=SUM(A1:A10)')", {
         documentName: z.string().describe("Name of the open document"),
         cellRef: z.string().describe("Cell reference, e.g. 'A1'"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iwork-mcp",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "MCP server for Apple iWork (Numbers, Pages, Keynote) automation",
   "license": "MIT",
   "type": "module",