iwork-mcp 0.3.0 → 0.4.0

package/dist/tools/keynote.js

@@ -171,6 +171,27 @@ export function registerKeynoteTools(server) {
       const masters = doc.masterSlides();
       return JSON.stringify(masters.map((m, i) => ({ index: i, name: m.name() })));
     `, { documentName })));
+    server.tool("keynote_reorder_slide", "Move a slide from one position to another", {
+        documentName: z.string().describe("Name of the open presentation"),
+        fromSlideNumber: z.number().describe("Current slide number (1-based)"),
+        toSlideNumber: z.number().describe("Target slide number (1-based)"),
+    }, async ({ documentName, fromSlideNumber, toSlideNumber }) => handleJXA(() => runJXA(`
+      const app = Application("Keynote");
+      const doc = app.documents.byName(params.documentName);
+      const slide = doc.slides[params.fromSlideNumber - 1];
+      app.move(slide, { to: doc.slides[params.toSlideNumber - 1] });
+      return JSON.stringify({ moved: true, from: params.fromSlideNumber, to: params.toSlideNumber, totalSlides: doc.slides.length });
+    `, { documentName, fromSlideNumber, toSlideNumber })));
+    server.tool("keynote_skip_slide", "Mark a slide as skipped (hidden) or unskipped", {
+        documentName: z.string().describe("Name of the open presentation"),
+        slideNumber: z.number().describe("Slide number (1-based)"),
+        skipped: z.boolean().describe("True to skip/hide, false to unskip/show"),
+    }, async ({ documentName, slideNumber, skipped }) => handleJXA(() => runJXA(`
+      const app = Application("Keynote");
+      const doc = app.documents.byName(params.documentName);
+      doc.slides[params.slideNumber - 1].skipped = params.skipped;
+      return JSON.stringify({ slideNumber: params.slideNumber, skipped: params.skipped });
+    `, { documentName, slideNumber, skipped })));
     server.tool("keynote_stop_slideshow", "Stop a running slideshow", {
         documentName: z.string().describe("Name of the open presentation"),
     }, async ({ documentName }) => handleJXA(() => runJXA(`

package/dist/tools/numbers.js

@@ -441,18 +441,113 @@ export function registerNumbersTools(server) {
       table.columns.push(app.Column());
       return JSON.stringify({ newColumnCount: table.columnCount() });
     `, { documentName, sheetName: sheetName ?? null, tableName: tableName ?? null })));
+    server.tool("numbers_read_range", "Read a specific cell range (e.g. 'B2:D10') instead of the entire table. Faster for large tables.", {
+        documentName: z.string().describe("Name of the open document"),
+        cellRange: z.string().describe("Cell range, e.g. 'A1:C10'"),
+        sheetName: z.string().optional().describe("Sheet name (defaults to first sheet)"),
+        tableName: z.string().optional().describe("Table name (defaults to first table)"),
+    }, async ({ documentName, cellRange, sheetName, tableName }) => 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];
+      const range = table.ranges[params.cellRange];
+      const cells = range.cells();
+      const values = cells.map(c => c.value());
+
+      // Figure out the range dimensions from the cell references
+      const rangeRef = range.name();
+      const colCount = range.columnCount();
+      const rowCount = range.rowCount();
+      const data = [];
+      for (let r = 0; r < rowCount; r++) {
+        data.push(values.slice(r * colCount, (r + 1) * colCount));
+      }
+      return JSON.stringify(data);
+    `, { documentName, cellRange, sheetName: sheetName ?? null, tableName: tableName ?? null })));
+    server.tool("numbers_merge_cells", "Merge a range of cells", {
+        documentName: z.string().describe("Name of the open document"),
+        cellRange: z.string().describe("Cell range to merge, e.g. 'A1:C1'"),
+        sheetName: z.string().optional().describe("Sheet name (defaults to first sheet)"),
+        tableName: z.string().optional().describe("Table name (defaults to first table)"),
+    }, async ({ documentName, cellRange, sheetName, tableName }) => 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];
+      const range = table.ranges[params.cellRange];
+      range.merge();
+      return JSON.stringify({ merged: true, cellRange: params.cellRange });
+    `, { documentName, cellRange, sheetName: sheetName ?? null, tableName: tableName ?? null })));
+    server.tool("numbers_unmerge_cells", "Unmerge a previously merged cell range", {
+        documentName: z.string().describe("Name of the open document"),
+        cellRange: z.string().describe("Cell range to unmerge, e.g. 'A1:C1'"),
+        sheetName: z.string().optional().describe("Sheet name (defaults to first sheet)"),
+        tableName: z.string().optional().describe("Table name (defaults to first table)"),
+    }, async ({ documentName, cellRange, sheetName, tableName }) => 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];
+      const range = table.ranges[params.cellRange];
+      range.unmerge();
+      return JSON.stringify({ unmerged: true, cellRange: params.cellRange });
+    `, { documentName, cellRange, sheetName: sheetName ?? null, tableName: tableName ?? null })));
+    server.tool("numbers_clear_cells", "Clear the contents of a cell or range", {
+        documentName: z.string().describe("Name of the open document"),
+        cellRange: z.string().describe("Cell or range to clear, e.g. 'A1' or 'A1:C10'"),
+        sheetName: z.string().optional().describe("Sheet name (defaults to first sheet)"),
+        tableName: z.string().optional().describe("Table name (defaults to first table)"),
+    }, async ({ documentName, cellRange, sheetName, tableName }) => 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];
+      if (params.cellRange.includes(":")) {
+        const range = table.ranges[params.cellRange];
+        const cells = range.cells();
+        for (const cell of cells) { cell.value = null; }
+      } else {
+        table.cells[params.cellRange].value = null;
+      }
+      return JSON.stringify({ cleared: true, cellRange: params.cellRange });
+    `, { documentName, cellRange, sheetName: sheetName ?? null, tableName: tableName ?? null })));
+    server.tool("numbers_sort_rows", "Sort table rows by a column", {
+        documentName: z.string().describe("Name of the open document"),
+        column: z.string().describe("Column letter to sort by, e.g. 'A'"),
+        order: z.enum(["ascending", "descending"]).optional().describe("Sort order (default: ascending)"),
+        sheetName: z.string().optional().describe("Sheet name (defaults to first sheet)"),
+        tableName: z.string().optional().describe("Table name (defaults to first table)"),
+    }, async ({ documentName, column, order, sheetName, tableName }) => 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];
+      const colStr = params.column.toUpperCase();
+      let colIndex = 0;
+      for (let i = 0; i < colStr.length; i++) {
+        colIndex = colIndex * 26 + (colStr.charCodeAt(i) - 64);
+      }
+      colIndex -= 1;
+      const col = table.columns[colIndex];
+      const direction = params.order === "descending" ? "descending" : "ascending";
+      table.sort({ by: col, direction: direction });
+      return JSON.stringify({ sorted: true, column: params.column, order: direction });
+    `, { documentName, column, order: order ?? null, sheetName: sheetName ?? null, tableName: tableName ?? null })));
     // ── Formatting Tools ──
-    server.tool("numbers_format_cells", "Set formatting on a cell or range: font, size, color, alignment, background color", {
+    server.tool("numbers_format_cells", "Set formatting on a cell or range: font, size, color, alignment, background color, bold, italic", {
         documentName: z.string().describe("Name of the open document"),
         cellRange: z.string().describe("Cell or range reference, e.g. 'A1' or 'A1:C3'"),
         format: z.object({
-            bold: z.boolean().optional().describe("Set bold"),
-            italic: z.boolean().optional().describe("Set italic"),
+            bold: z.boolean().optional().describe("Set bold (switches to bold variant of current font)"),
+            italic: z.boolean().optional().describe("Set italic (switches to italic variant of current font)"),
             fontSize: z.number().optional().describe("Font size in points"),
             fontName: z.string().optional().describe("Font name"),
             textColor: z.string().optional().describe("Text color as hex, e.g. '#FF0000'"),
             backgroundColor: z.string().optional().describe("Background color as hex, e.g. '#0000FF'"),
             alignment: z.enum(["left", "center", "right", "auto"]).optional().describe("Text alignment"),
+            verticalAlignment: z.enum(["top", "center", "bottom"]).optional().describe("Vertical alignment"),
+            textWrap: z.boolean().optional().describe("Enable text wrapping"),
         }).describe("Formatting options"),
         sheetName: z.string().optional().describe("Sheet name (defaults to first sheet)"),
         tableName: z.string().optional().describe("Table name (defaults to first table)"),
@@ -463,7 +558,6 @@ export function registerNumbersTools(server) {
       const table = params.tableName ? sheet.tables.byName(params.tableName) : sheet.tables[0];
       const fmt = params.format;
 
-      // Parse range like "A1:C3" into individual cells
       const rangeStr = params.cellRange;
       let cells = [];
       if (rangeStr.includes(":")) {
@@ -481,7 +575,6 @@ export function registerNumbersTools(server) {
       }
 
       for (const cell of cells) {
-        if (fmt.bold !== undefined) cell.textColor = cell.textColor; // touch to ensure access
         if (fmt.fontSize !== undefined) cell.fontSize = fmt.fontSize;
         if (fmt.fontName !== undefined) cell.fontName = fmt.fontName;
         if (fmt.textColor !== undefined) {
@@ -493,11 +586,25 @@ export function registerNumbersTools(server) {
           cell.backgroundColor = [r, g, b];
         }
         if (fmt.alignment !== undefined) {
-          const alignMap = { left: "left", center: "center", right: "right", auto: "auto" };
-          cell.alignment = alignMap[fmt.alignment];
+          cell.alignment = fmt.alignment;
+        }
+        if (fmt.verticalAlignment !== undefined) {
+          cell.verticalAlignment = fmt.verticalAlignment;
+        }
+        if (fmt.textWrap !== undefined) {
+          cell.textWrap = fmt.textWrap;
         }
-        if (fmt.bold !== undefined) {
-          cell.format = cell.format; // Numbers doesn't have direct bold; we use font
+        // Bold/italic: switch font to bold/italic variant
+        if (fmt.bold !== undefined || fmt.italic !== undefined) {
+          let fontName = fmt.fontName || cell.fontName();
+          const baseName = fontName.replace(/ ?(Bold|Italic|Bold Italic|BoldItalic)$/i, "").trim();
+          let suffix = "";
+          const wantBold = fmt.bold !== undefined ? fmt.bold : /Bold/i.test(fontName);
+          const wantItalic = fmt.italic !== undefined ? fmt.italic : /Italic/i.test(fontName);
+          if (wantBold && wantItalic) suffix = " Bold Italic";
+          else if (wantBold) suffix = " Bold";
+          else if (wantItalic) suffix = " Italic";
+          cell.fontName = baseName + suffix;
         }
       }
 

package/dist/tools/pages.js

@@ -109,17 +109,42 @@ export function registerPagesTools(server) {
       })));
     `, { documentName })));
     // ── Text Writing Tools ──
-    server.tool("pages_add_text", "Append text to the end of the document body", {
+    server.tool("pages_add_text", "Append text to the end of the document body (preserves existing formatting)", {
         documentName: z.string().describe("Name of the open document"),
         text: z.string().describe("Text to append"),
     }, async ({ documentName, text }) => handleJXA(() => runJXA(`
       const app = Application("Pages");
       const doc = app.documents.byName(params.documentName);
-      const current = doc.bodyText();
-      doc.bodyText = current + params.text;
-      return JSON.stringify({ appended: true });
+      // Append by adding a new paragraph to preserve existing formatting
+      const para = app.Paragraph({ text: params.text });
+      doc.paragraphs.push(para);
+      return JSON.stringify({ appended: true, paragraphCount: doc.paragraphs.length });
     `, { documentName, text })));
-    server.tool("pages_replace_text", "Find and replace text in a Pages document", {
+    server.tool("pages_insert_text_at", "Insert text at a specific paragraph index", {
+        documentName: z.string().describe("Name of the open document"),
+        text: z.string().describe("Text to insert"),
+        afterParagraph: z.number().describe("Insert after this paragraph index (0-based). Use -1 to insert at the beginning."),
+    }, async ({ documentName, text, afterParagraph }) => handleJXA(() => runJXA(`
+      const app = Application("Pages");
+      const doc = app.documents.byName(params.documentName);
+      const para = app.Paragraph({ text: params.text });
+      if (params.afterParagraph < 0) {
+        doc.paragraphs.unshift(para);
+      } else {
+        doc.paragraphs.splice(params.afterParagraph + 1, 0, para);
+      }
+      return JSON.stringify({ inserted: true, paragraphCount: doc.paragraphs.length });
+    `, { documentName, text, afterParagraph })));
+    server.tool("pages_delete_text", "Delete a paragraph by index", {
+        documentName: z.string().describe("Name of the open document"),
+        paragraphIndex: z.number().describe("Paragraph index to delete (0-based)"),
+    }, async ({ documentName, paragraphIndex }) => handleJXA(() => runJXA(`
+      const app = Application("Pages");
+      const doc = app.documents.byName(params.documentName);
+      app.delete(doc.paragraphs[params.paragraphIndex]);
+      return JSON.stringify({ deleted: true, paragraphCount: doc.paragraphs.length });
+    `, { documentName, paragraphIndex })));
+    server.tool("pages_replace_text", "Find and replace text in a Pages document (operates per-paragraph to preserve formatting)", {
         documentName: z.string().describe("Name of the open document"),
         find: z.string().describe("Text to find"),
         replace: z.string().describe("Replacement text"),
@@ -127,23 +152,24 @@ export function registerPagesTools(server) {
     }, async ({ documentName, find, replace, all }) => handleJXA(() => runJXA(`
       const app = Application("Pages");
       const doc = app.documents.byName(params.documentName);
-      const current = doc.bodyText();
+      const paragraphs = doc.paragraphs();
       let count = 0;
-      let newText;
-      if (params.all !== false) {
-        const parts = current.split(params.find);
-        count = parts.length - 1;
-        newText = parts.join(params.replace);
-      } else {
-        const idx = current.indexOf(params.find);
-        if (idx !== -1) {
-          newText = current.substring(0, idx) + params.replace + current.substring(idx + params.find.length);
+      for (let i = 0; i < paragraphs.length; i++) {
+        const p = paragraphs[i];
+        let text;
+        try { text = p.text ? p.text() : ""; } catch(e) { continue; }
+        if (text.indexOf(params.find) === -1) continue;
+        if (params.all !== false) {
+          const parts = text.split(params.find);
+          count += parts.length - 1;
+          doc.paragraphs[i].text = parts.join(params.replace);
+        } else if (count === 0) {
+          const idx = text.indexOf(params.find);
+          doc.paragraphs[i].text = text.substring(0, idx) + params.replace + text.substring(idx + params.find.length);
           count = 1;
-        } else {
-          newText = current;
+          break;
         }
       }
-      doc.bodyText = newText;
       return JSON.stringify({ replacements: count });
     `, { documentName, find, replace, all: all ?? true })));
     server.tool("pages_format_text", "Set formatting on a paragraph: font, size, color, bold, italic", {

package/package.json

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