Skip to main content
Glama

CI Version License: MIT iWork MCP server Arabic safe Undo

The safe way to let AI edit your Numbers, Keynote and Pages files.

Designed decks from your data and your brand, checked as rendered. Arabic-ready. Every change is backed up, verified and undoable, and anything risky is refused, never guessed.

🛡️ Never damages your file

🎨 Designed from your data

ع Arabic first-class

Backup → change a copy → re-read and compare → atomic swap. Open files are left alone. One call undoes any change.

Turn a spreadsheet into a Keynote deck with chart and table slides in your brand kit, then review it as rendered.

Arabic and right-to-left text round-trip exactly, in every app and every export.

Install · Try it · Safety · What it can do · All tools · For AI agents · Changelog

15 seconds: data → designed deck → a safe rollback → Arabic. HD video

▶ Watch the film with sound (46s) · Read the launch story


Install

Your app

Do this

Claude desktop app, one click (Mac)

Download iwork-studio-<version>.mcpb from the latest release, double-click it, pick the folders it may use

Claude desktop app (Mac, from Terminal)

Paste in Terminal: curl -LsSf https://raw.githubusercontent.com/Arkanji/iwork-studio/main/install.sh | sh, then quit Claude (Cmd-Q) and reopen

Claude Code, as a plugin (tools + skill)

/plugin marketplace add Arkanji/iwork-studio, then /plugin install iwork-studio@iwork-studio

Claude Code, tools only

claude mcp add iwork-studio -- uvx --from iwork-studio@latest iwork-studio-mcp

Hermes Agent (tools + skill)

hermes plugins install iwork-studio, then hermes plugins enable iwork-studio. See hermes/

Cursor, VS Code, Codex, any MCP client

uvx --from iwork-studio@latest iwork-studio-mcp config, then paste the printed JSON into the client's MCP settings. Also listed in the MCP Registry as io.github.Arkanji/iwork-studio

That's it. The installer sets up uv if needed, and uv brings its own Python.

  • Fence it (recommended): … | sh -s -- --roots ~/Documents ~/Desktop limits it to those folders. Other clients: set IWORK_STUDIO_ROOTS (:-separated).

  • Load less (optional): only work in Keynote? Set IWORK_STUDIO_TOOLSETS=keynote,design (any of files, numbers, keynote, pages, design; default all). Fewer tools keep the AI focused and its context small. The Claude Desktop extension has a Toolsets field; in Claude Code: claude mcp add iwork-studio -e IWORK_STUDIO_TOOLSETS=keynote,design -- uvx --from iwork-studio@latest iwork-studio-mcp. Capabilities, read, find, undo and the kit list always load.

  • First run: macOS asks once whether Claude may control Keynote / Pages / Numbers. Click OK. (Missed it? System Settings → Privacy & Security → Automation.)

  • Check it: ask "what can iwork-studio do on this Mac?".

  • Remove: uvx --from iwork-studio@latest iwork-studio-mcp uninstall

AI agent setting this up for someone? Pick the row for their app, run it, then call iwork_capabilities. Rules for using the tools are in AGENTS.md.

Related MCP server: docforge-mcp

Just ask, in English or Arabic

No file handy? Ask "copy the iWork Studio samples to my Desktop and turn sample-sales.numbers into a board deck". The samples are synthetic sales data with an English and an Arabic sheet.

"Build a 6-slide pitch deck for a solar-panel startup in the midnight kit, with speaker notes, and export it to PowerPoint."

"Turn sales.numbers into a board deck: chart the quarters, a table of the top regions, in our Acme kit."

"Take the fonts and colours from brand.key and save them as our Acme kit."

"Review pitch.key and fix anything that overflows or is too small to read."

"Make budget.numbers look professional with the banking kit — and show me a preview first."

"Turn sales.csv into a Numbers file, make the header bold on a teal fill, show column B as SAR with two decimals, and add a total row."

"In pitch.key, switch to the Gradient theme, make the title on slide 1 white at 60 pt, add a dissolve between every slide, and put logo.png on the last slide."

"Add a bar chart of revenue by quarter for 2025 and 2026 to slide 4."

"Duplicate slide 3, move the copy to the front and add presenter notes: ملاحظات المتحدث"

"Fill the Name and Date fields in offer-letter.pages, then export it as a password-protected PDF."

"In the invoice.pages table, set the quantity in B3 to 12 and make D9 the total of D2:D8."

"Find my Keynote decks from this week and export each one to PowerPoint."

"Undo the last change to budget.numbers."

What it can do

Numbers

Keynote

Pages

Read

Every sheet, table, cell, formula and format

Every slide's text, notes, layout, theme, styling and charts

Body text, placeholders and tables

Create

From data or CSV ⚡ · from a built-in template · from your own file

A designed deck from an outline, with chart and table slides (straight from a Numbers table) · from a built-in theme · from your own deck

From a built-in template · from your own file

Edit content

Cells ⚡ · formulas · recalculate · insert/delete rows and columns ⚡ · add tables and sheets ⚡ · sort

Find/replace across the deck ⚡ · slide titles and bullets · add, duplicate, delete, move, hide slides · presenter notes · images · charts · tables

Replace text everywhere · replace the body · fill placeholders · table cells (text, numbers, formulas)

Design

Design kits ⚡ · your brand kit ⚡ · fonts, colours, fill, alignment, wrap ⚡ · currency, %, dates, decimals ⚡ · borders ⚡ · widths and heights ⚡ · headers ⚡ · merges ⚡

Design kits · your brand kit · theme · slide layout · text font, size and colour · styled tables · transitions

—

Review

Design review of what Keynote draws: text off the slide or past its box, text Keynote had to shrink, overlaps, small text, crowded slides · any slide as an image

Export

PDF · Excel · CSV

PDF · PowerPoint · images · movie

PDF · Word · EPUB · text · RTF

Present

Start, stop, next, previous

⚡ = works anywhere, no app needed (pure Python). Everything else drives the real app on a Mac with a logged-in session, classic iWork or the Creator Studio apps.

Every file type: preview any change before it's made (dry_run), look up metadata, pull the preview thumbnail, find files with Spotlight, check that a word is visibly rendered, check the rendered font/size/colour, list backups and undo.

What it won't do

On purpose, so it never breaks a file:

  • Files with charts are refused by the tools that work without the app: their rewrite can silently break a chart's link to its data. The app-driven tools (Keynote slides, theming, transitions, images; Numbers formulas and sort) work on them and check every chart is still there.

  • Charts in Numbers and Pages aren't created: they aren't reliably scriptable, and we refuse rather than click through the app's menus and risk your file. Keynote charts can be added. To chart sorted data without touching a Numbers chart, sort into a new table (numbers_sort with to_new_table) and build a Keynote chart slide from it.

  • Pages is limited to text and existing tables: replace, set body, placeholders and table cells. New tables can't be created (Pages 15 doesn't script it), and page-layout documents, like most letter templates, have no body text. There is no Pages file format parser anywhere, so it doesn't fake one.

  • Formulas and row shifts: in a table that has formulas, rows and columns can only be appended without the app. Inserting in the middle would leave references pointing at the wrong cells.

  • Not scriptable by Apple, so not offered: Numbers table styles, Keynote shape fill and text alignment, deleting a Keynote table, editing a theme's master slides. Page margins and page setup are planned.

Designed, not just edited

Six design kits turn a plain deck or table into something you'd present: a font pair (Latin + Arabic, all bundled with macOS — nothing to install), a restrained palette checked for WCAG contrast, and a type scale.

Kit

Feel

executive

Calm and corporate: slate neutrals, one blue accent

banking

Trust and weight: deep navy, restrained gold

classic

Formal reports and boards: serif headings, navy and amber

teal

Fresh and confident: deep teal

analytics

Data-forward: strong blue, amber highlights

midnight

Dark stage: near-black slides, white titles, mint accent

Build with one (keynote_build_deck(..., kit="midnight")), restyle anything (keynote_apply_design, numbers_apply_design), or bring your brand as colours and fonts — contrast is checked. Agents also get a design guide: one idea per slide, titles that state the takeaway, right-aligned numbers, restrained colour.

Your brand, once. Point iwork_extract_design_kit at a deck or table that already has your look: it reads the fonts (Latin and Arabic) and colours, and saves them as a named kit you can use anywhere a kit goes. Or save your colours and fonts directly with iwork_save_design_kit.

Numbers on slides. A slide in keynote_build_deck can carry a chart or a table, from data or straight from a Numbers table: the header row gives the columns, the first column the rows. Tables get the kit's header band, fonts, banding and right-aligned numbers, and every cell is read back.

It checks its own work. keynote_review_deck renders the deck through Keynote and compares every drawn line with its text box: text off the slide or running past its box is an error; text Keynote had to shrink to fit, overlapping boxes, text under 18 pt and crowded slides are warnings. keynote_slide_image hands a slide back as an image, so an agent can look before it says "done".

The safety model

An iWork app will happily say "saved" about a file it just broke. Nothing here trusts "saved".

backup → change a scratch copy → re-open it and compare → atomic swap
                       ↘ anything off: your file is untouched, the error says why
  • Backup first, versioned and private: in ~/.iwork-studio/backups/ (or IWORK_STUDIO_BACKUP_DIR), never beside your file, so backups don't fill or sync your iCloud Desktop and Documents. The last 10 per file are kept.

  • Never behind the app's back: if the file is open in Numbers, Keynote or Pages, the write is refused. The app's next save would quietly overwrite the change.

  • Re-read and compared: exactly the requested change happened, and nothing else did. A cell edit reads the edited cell back and checks every other cell. A row insert checks every cell at its new position. A slide op checks every other slide. A sort checks it's a pure reorder, and refuses up front when the table's formulas read other rows (Numbers' own sort would break them). On files with charts, every chart is counted before and after; on decks with tables, every table's cells are compared. An export is read back with a second, independent tool.

  • Atomic swap: the file is replaced in one step, so a crash can't leave half a file.

  • The app's "ok" is never trusted. App-driven writes are re-read from disk, and a write that "succeeded" but didn't land is rolled back.

  • Undo is one call: iwork_list_backups → iwork_restore_backup. The restore backs up the current version first, so undo can be undone too.

  • Preview first: every write that changes an existing document takes dry_run=true (restore and export are the exceptions). It runs the real change on a throwaway copy, with every check, and shows exactly what would change. Your file isn't touched.

  • Find and replace keeps formatting: in Pages, only the paragraphs that contain the text are rewritten.

  • New files never overwrite an existing one.

  • Refuse, don't mangle. The worst case is a clear "no", never a broken file.

Arabic & RTL

  • Arabic text round-trips exactly in all three apps, including presenter notes, Pages placeholders and Pages table cells.

  • Paragraph direction is checked in Pages. A replace that flips a right-to-left paragraph to left-to-right is rolled back. Pages writes new paragraphs left-to-right, even Arabic ones, and scripting can't change that, so those are flagged: set the direction in Pages (Format › Text).

  • Values are kept as typed: Arabic-Indic digits (١٢٣), "$1,234.56" and =… text stay text. Pass a real number when you want a number.

  • When checking a rendered PDF, assert one Arabic word. PDF text layers reorder multi-word RTL text.

All 65 tools

Writes are marked destructive and reads read-only, so clients can ask before writing. Every write that changes an existing file takes dry_run=true for a preview. Every tool has a title, every parameter a description, and every tool says when to use it instead of its siblings. Need fewer? Load only some toolsets (see Load less under Install).

Tool

What it does

iwork_capabilities

What this machine can do: apps, GUI session, which routes work

iwork_read

Any .numbers / .key / .pages → JSON

iwork_find

Find iWork files by kind and name (Spotlight on a Mac)

iwork_samples

Copy sample files (synthetic sales data, English and Arabic) to try it with nothing of your own

iwork_metadata · iwork_thumbnail

Template, app builds, format version, slide count · the stored preview image

iwork_create · iwork_create_from_template

New file from Apple's built-in templates · copy of your own file

iwork_list_templates

Built-in templates (Numbers, Pages) and themes (Keynote)

iwork_list_design_kits

Design kits: fonts, palettes, type scale — presets and your saved kits

iwork_extract_design_kit

A kit from your own deck or table: its fonts and colours; save it by name

iwork_save_design_kit · iwork_delete_design_kit

Keep your brand kit by name · remove one

iwork_export

PDF, Excel, CSV, Word, EPUB, text, RTF, PowerPoint, slide images, movie; optional password

iwork_verify_render · iwork_verify_format

Rendered PDF shows this text · with this font, size, colour, page size

iwork_list_backups · iwork_restore_backup

Undo

Tool

What it does

numbers_create · numbers_import_csv

New file from rows of data · from a CSV/TSV

numbers_edit_cell

Set one cell

numbers_set_formula

Put a formula in a cell; Numbers computes it

numbers_recalculate

Have Numbers recompute every formula after edits made without it

numbers_insert · numbers_delete

Rows or columns, anywhere

numbers_add_table

New table on a sheet, or on a new sheet

numbers_sort

Sort body rows by a column. A table whose formulas read other rows is refused, since Numbers' sort would break them; to_new_table puts a sorted copy of its values in a new table and leaves the original, its formulas and its charts alone

numbers_inspect_format

Widths, heights, headers, merges, and every cell's style, number format and borders

numbers_set_cell_style

Font, size, bold/italic/underline/strike, colours, fill, alignment, wrap

numbers_set_number_format

Number, currency (any ISO code), %, scientific, fraction, date, text; decimals, separators, negatives

numbers_set_borders

All / outline / inner / one side; width, colour, style

numbers_set_dimensions · numbers_set_headers · numbers_merge_cells

Column widths and row heights · header rows/columns · merges

Tool

What it does

keynote_build_deck

A new deck from an outline: titles, bullets, notes, images, chart and table slides, transition, design kit

keynote_review_deck

Design review of the rendered deck: off-slide and overflowing text, overlaps, small text, crowded slides

keynote_slide_image

One slide as an image, to look at

keynote_set_slide_text

Fill a slide's title and body

keynote_apply_design

Restyle every slide from a design kit

keynote_replace_text

Find/replace on every slide, formatting untouched

keynote_list_slides

Every slide's text, notes, hidden state and chart count

keynote_add_slide · keynote_duplicate_slide · keynote_delete_slide · keynote_move_slide · keynote_skip_slide

Slide operations

keynote_set_presenter_notes

Presenter notes

keynote_list_themes · keynote_inspect_style

Available themes · a deck's theme, layouts and text styling

keynote_set_theme · keynote_set_slide_layout · keynote_format_text

Theme · one slide's layout · one text item's font, size, colour

keynote_set_transition

Effect, duration, delay, auto-advance

keynote_add_image

Place an image on a slide

keynote_add_chart

Add a bar, line, area, pie or scatter chart from data

keynote_add_table

Add a table, styled from a design kit; every cell is read back

keynote_slideshow

Start, stop, next, previous

Tool

What it does

pages_preflight

Checks Pages can answer (run once first)

pages_replace_all · pages_set_body

Replace text everywhere · replace the whole body (resets its formatting)

pages_list_placeholders · pages_fill_placeholders

Template fields like Name and Date

pages_read_tables · pages_set_table_cells

Read every table · write text, numbers and formulas into an existing table

Keynote slide, theme, transition and image tools refuse a deck that's open in Keynote (they never close a window that may hold unsaved work). To hide them all: IWORK_STUDIO_DISABLE_SLIDE_OPS=1.

Prompts. Clients that show MCP prompts get four ready-made workflows: Pitch deck from an outline, Report deck from a Numbers table, Restyle with my brand and Make this table look designed. Each writes to the design rules, builds in one call, previews before restyling, and runs the design review before it calls the job done.

For AI agents

  • AGENTS.md: setup and usage rules for any agent (Codex, Cursor, Copilot, Gemini; Claude Code reads it via CLAUDE.md).

  • MCP instructions: the server sends its rules on connect, so the model has them even without this repo.

  • Skill: skill-pack/SKILL.md, auto-discovered by Claude Code in this repo, or bash skill-pack/install.sh for other skill-based agents. It includes CLI scripts with JSON output for agents without MCP.

  • llms.txt: a short machine-readable summary.

The contract: JSON in, JSON out. Errors are typed and say what to tell the user: ChartRefusalError, DocumentOpenError, PagesOutOfScopeError, AquaSessionError (no Mac GUI here) and so on. Don't retry a refused write with a trick.

Python

pip install iwork-studio      # Python 3.12
from iwork_studio import numbers_structure, numbers_format, numbers_io, keynote_io, keynote_slides, exporter, backups

from iwork_studio import keynote_deck, design, review

keynote_deck.build_deck("pitch.key", [{"title": "شمس", "body": "Clean energy for every home"},
                                      {"title": "Why now", "body": ["Trust", "Access"]},
                                      {"title": "Riyadh leads growth", "chart": {"type": "bar", "from": "sales.numbers"}}],
                        kit="midnight")                                  # macOS + Keynote
review.review_deck("pitch.key")["findings"]                              # macOS + Keynote
design.extract_kit("brand.numbers", name="Acme", save=True)
numbers_structure.import_csv("sales.csv", "sales.numbers")
design.apply_to_numbers("sales.numbers", "banking")
numbers_format.set_cell_style("sales.numbers", "A1:D1", bold=True, fill_color="#1A7F79", font_color="#FFFFFF")
numbers_format.set_number_format("sales.numbers", "B2:B99", "currency", currency_code="SAR", decimal_places=2)
numbers_io.edit_cell("sales.numbers", "B2", 2500)
keynote_io.edit_text("pitch.key", "2025", "2026")
keynote_slides.set_presenter_notes("pitch.key", 1, "ملاحظات")          # macOS + Keynote
exporter.export("pitch.key", "pptx")                                     # macOS + Keynote
backups.restore_backup("sales.numbers", backups.list_backups("sales.numbers")[0]["name"])
  1. save in <path> is denied by the iWork sandbox. In-place save and export work. → sandbox-trap.md

  2. Keynote's slide title/body properties throw -1700. Use the text item's object text. → keynote-1700-defect.md

  3. Chart files corrupt quietly when the file-level libraries rewrite them, so those routes refuse them. When the app makes the edit it keeps its own charts linked, so app-driven routes allow them and count every chart before and after.

  4. Byte-equal saves don't exist in iWork's format. The real bar is semantic: it reopens, and the full model matches.

  5. First-run permission and template-chooser dialogs block every script call. A preflight turns the hang into one clear prompt. → tcc-preflight.md

  6. "Creator Studio" apps have different names. A hardcoded Application("Numbers") drives the wrong app; names are resolved per call. → apps.py

  7. stdout is the MCP wire. Import-time warnings from libraries would corrupt it, so they go to stderr.

  8. Keynote's JavaScript insert and move are broken; AppleScript make new slide and move slide … to before slide … work.

  9. Keynote master slides can't be reached from JavaScript (-1700); layouts go through AppleScript.

  10. numbers-parser doesn't save in-place style edits. Styles are registered first, then applied.

  11. numbers-parser stored 12 as 12.000000000000002. Decimals are now encoded exactly.

  12. numbers-parser doesn't update formula references when rows move, so mid-table inserts in formula tables are refused.

  13. Keynote colours are 0–65535 per channel, not 0–255 or 0–1.

  14. Pages page-layout documents have no body text (bodyText() is null), and most letter and flyer templates are page layout. Placeholders are filled and checked across every text box instead.

  15. Pages tables are invisible to JavaScript scripting but readable and writable from AppleScript; creating tables is broken in Pages 15, so only existing tables are offered.

  16. The Pages sandbox refuses AppleScript open for files outside it; JavaScript open is allowed, so documents are opened that way and then found by their exact path.

  17. numbers-parser can break formulas on re-save (an upstream report). Every no-app write compares every formula, so a broken one is caught and nothing changes.

  18. Numbers doesn't recalculate formulas when it opens a file changed without it: a total keeps its old result. Edits made without the app say so, and numbers_recalculate has Numbers recompute every formula.

  19. A rounding library used by numbers-parser wipes every warning filter in the process on each save. It's wrapped so it stays quiet without touching anyone else's settings.

  20. Don't keep the repo in iCloud Drive. Sync creates "main 2" copies inside .git.

  21. Keynote creates tables only one way: tell slide n to make new table works, while make new table at end of tables of slide n and deleting a table fail with -10000. A failed table add is undone by restoring the backup.

More, each with its status: jxa-traps.md (including traps borrowed from reichenbach/iwork_mcp).

pure Python file parsers (headless, deterministic)  →  .numbers everything, .key text
the real app via AppleScript / JXA                   →  .key slides & theming, .pages text & tables, formulas, sort, export, render checks
MCP server · CLI scripts · skill                     →  thin wrappers over the same library and the same safety model
src/iwork_studio/   numbers_io · numbers_format · numbers_structure · keynote_io · keynote_slides · keynote_theme
                    keynote_deck · keynote_table · design · review · preview · pages_io · app_ops · exporter
                    helpers · format_check · render_verify · pdf · backups · apps · mcp_server
mcpb/               Claude Desktop extension manifest (scripts/build_mcpb.sh builds the .mcpb)
skill-pack/         SKILL.md · CLI scripts · references (capabilities, traps, pins); also the Claude Code plugin
.claude-plugin/     plugin marketplace (one plugin: skill-pack/)
tests/              headless suite (CI) · `pytest -m aqua` = live suite for a Mac with iWork
install.sh          one-line setup for the Claude desktop app

Contributing

git clone https://github.com/Arkanji/iwork-studio.git && cd iwork-studio
uv run --extra test pytest -m "not aqua"      # headless suite, what CI runs
uv run --extra test pytest -m aqua            # live suite: a Mac with Numbers, Keynote and Pages
scripts/live.sh                               # the same, unattended: logs to ~/.iwork-studio/probes, quits the apps it opened

iWork changes between releases. If something breaks, check the capabilities and traps, run the live suite, and pin what changed. New write routes must follow the safety model and come with tests that prove the rollback. Clone outside iCloud-synced folders.

License

MIT, traps included. Take them.

Available Tools

65 tools
iwork_capabilitiesWhat this Mac can doA
Read-only

What this machine can do right now: routes, GUI session, installed apps, Keynote slide-op status. Call first when unsure. Call first when unsure what this machine can do: which apps exist, whether a GUI session is available, which toolsets are loaded. Not needed before plain reads of .numbers or .key files.

Inputs: no named parameters. Returns: object

iwork_createNew file from a built-in templateA
Destructive

New .numbers / .key / .pages from Apple's built-in templates (Keynote: themes); names from iwork_list_templates. Omit template for Blank / Basic White. Refuses to overwrite. Needs macOS + the app. Use for a new, empty file from Apple's templates. Instead: iwork_create_from_template to copy the user's own file, numbers_create to make a Numbers file from data, keynote_build_deck for a finished deck from an outline.

Inputs: path (required), template. Returns: object

iwork_create_from_templateNew file from your own fileA
Destructive

Start a new document from one of the user's own files (any .numbers / .key / .pages): copies it to path and checks it opens. Refuses to overwrite. Use when the user has their own template or past file to start from. For Apple's built-in templates use iwork_create.

Inputs: path (required), template (required). Returns: object

iwork_delete_design_kitDelete design kitA
Destructive

Delete a saved design kit (presets can't be deleted). Returns the kit's contents, so it can be saved again with iwork_save_design_kit. Use only when the user asks to remove a saved kit. To change a kit, save it again with overwrite=true instead.

Inputs: name (required). Returns: object

iwork_exportExport (PDF, Excel, Word, PowerPoint…)A
Destructive

Export to another format. Numbers: pdf | xlsx | csv. Pages: pdf | docx | epub | txt | rtf. Keynote: pdf | pptx | images | movie. Optional password (+hint) for pdf/xlsx/docx/pptx, image_quality (good|better|best), image_format for slide images (jpeg|png|tiff). Default output sits next to the source. The export is checked against the source with a second tool and the source is verified unchanged. Needs macOS + the app. Use to hand the result over in another format (PDF, Excel, Word, PowerPoint, images). Never export to docx/pptx/xlsx to edit and convert back: edit the iWork file directly.

Inputs: path (required), format (required), out, password, +4 more. Returns: object

iwork_extract_design_kitExtract design kitA
Idempotent

Make a design kit from the user's own deck or table: heading and body fonts (Latin and Arabic) and the title, body and brand colours. .numbers reads the table's header and body styles (no app); .key reads every slide's title and body (needs macOS + Keynote). Parts the file doesn't show come from the nearest preset and are listed in notes. save=true with a name keeps it for reuse by name (contrast must pass). The file is never changed. Use when the user has a deck or table that already has their brand look. If they give colours and fonts directly use iwork_save_design_kit instead.

Inputs: path (required), name, save, sheet, +2 more. Returns: object

iwork_findFind iWork filesA
Read-only

Find Numbers / Keynote / Pages files (newest first). kind: numbers | keynote | pages; name: part of the file name. Searches folder, else the allowed folders, else Documents/Desktop/Downloads. Uses Spotlight on macOS. Use when the user names a file loosely ("my sales deck") or you don't know its path; then read it with iwork_read. Not needed when you already have the path.

Inputs: kind, name, limit, folder. Returns: object

iwork_list_backupsList backupsA
Read-only

List the versioned backups (newest first) every write left for this file, plus the Keynote write manifest. Use when the user wants to undo or compare versions: it lists the backups, then iwork_restore_backup restores one. Not needed after a failed tool call: failed writes never change the file.

Inputs: path (required). Returns: object

iwork_list_design_kitsList design kitsA
Read-only

Design kits for good-looking decks and tables: font pairs (Latin + Arabic, bundled with macOS), contrast-checked palettes and a type scale. Lists the presets and the kits you saved (saved: true). Use with keynote_build_deck(kit=…), keynote_apply_design, numbers_apply_design. Custom kits: pass {"fonts": {...}, "colors": {...}}. Use before any styling to pick a kit, and to see the user's saved brand kits. Pass the name as kit= to keynote_build_deck, keynote_apply_design or numbers_apply_design.

Inputs: no named parameters. Returns: object

iwork_list_templatesList templatesA
Read-onlyIdempotent

Built-in templates for Numbers or Pages, or themes for Keynote (app: numbers | pages | keynote). Needs macOS + the app. Use before iwork_create to get valid template or theme names. Not needed for iwork_create_from_template, which copies the user's own file.

Inputs: app (required). Returns: object

iwork_metadataFile detailsA
Read-only

What a file says about itself, without the app: kind, size, modified, template it was made from, app builds that saved it, file format version, slide count (Keynote), embedded media count. Use for file facts (template, app build, slide count) without reading content. For the content itself use iwork_read.

Inputs: path (required). Returns: object

iwork_readRead an iWork fileA
Read-only

Read a .numbers, .key or .pages file into JSON (.pages needs the Pages app and a GUI session). Use to see a file's content before editing it. Not for formatting details: use numbers_inspect_format (Numbers) or keynote_inspect_style (Keynote). For file facts only, iwork_metadata is cheaper.

Inputs: path (required). Returns: object

iwork_restore_backupUndo: restore a backupA
Destructive

Undo: atomically restore a backup (a name from iwork_list_backups). The current version is backed up first. Use to undo a change, with a backup name from iwork_list_backups. The current version is backed up first, so a restore can itself be undone.

Inputs: path (required), backup (required). Returns: object

iwork_samplesCopy sample files to tryA
Idempotent

Copy sample files (sample-sales.numbers with English and Arabic sheets of synthetic sales data, and sample-outline.md for a deck) into a folder, so a first try needs none of the user's own files. Never overwrites. Returns try-it prompts. Use when the user wants to try iWork Studio but has no file handy, or asks for an example; then follow one of the returned try_it prompts. Not for the user's own files.

Inputs: folder (required). Returns: object

iwork_save_design_kitSave design kitA
Idempotent

Save a design kit by name for reuse anywhere a kit is accepted. kit = {"fonts": {...}, "colors": {...}, "theme": "...", "background": "#RRGGBB"} (missing parts come from the "executive" preset, or from "base": ""), or a preset name to copy. Contrast is checked (4.5:1). Never replaces a saved kit unless overwrite=true; can't reuse a preset's name. Use when the user gives brand colours and fonts directly. To capture them from an existing file use iwork_extract_design_kit.

Inputs: kit (required), name (required), overwrite. Returns: object

iwork_thumbnailPreview imageA
Read-only

Extract the preview image stored in the file (first page/slide) to a JPEG and return its path — a quick look without opening the app. Reflects the app's last save. Use for a quick look at the stored first-page preview with no app. It reflects the last save in the app, not your latest edits: to see a slide as it renders now, use keynote_slide_image.

Inputs: path (required), out_dir. Returns: object

iwork_verify_formatCheck rendered formattingA
Read-onlyIdempotent

Independent check of formatting: export a PDF through the app and confirm text is drawn with the given font (name contains), size (pt), color (#RRGGBB), bold, and page size (pt). Needs macOS + the app. Use to prove how a piece of text is drawn (font, size, colour, page size). To check text is merely present use iwork_verify_render.

Inputs: path (required), text (required), bold, font, +4 more. Returns: object

iwork_verify_renderCheck text is renderedA
Read-onlyIdempotent

Export the file to PDF through its app and assert assert_text is visibly rendered. For Arabic, use one word. Use after an important write to prove the text really shows when rendered. To check font, size or colour use iwork_verify_format; to check a deck's whole design use keynote_review_deck.

Inputs: path (required), assert_text (required), expected_pages. Returns: object

keynote_add_chartKeynote: add chartA
Destructive

Add a chart to a slide from data. rows = series names, columns = category names, data = one list of numbers per row (rows × columns). type: bar | stacked_bar | horizontal_bar | stacked_horizontal_bar | line | area | stacked_area | pie | scatter (or *_3d). group_by: row | column. Text and other charts are verified untouched. dry_run=true previews the change on a copy without touching the file. Use for a chart on an existing slide. In a new deck, put the chart in keynote_build_deck's outline instead; for exact numbers use keynote_add_table.

Inputs: data (required), path (required), rows (required), slide (required), +4 more. Returns: object

keynote_add_imageKeynote: add imageA
Destructive

Place an image file (png, jpg, heic, pdf…) on a slide; optional x/y position and width in points. All text verified untouched. dry_run=true previews the change on a copy without touching the file. Use to place a picture or logo on a slide. For data, use keynote_add_chart or keynote_add_table rather than a picture of a chart.

Inputs: path (required), image (required), slide (required), x, +3 more. Returns: object

keynote_add_slideKeynote: add slideA
Destructive

Insert a slide after slide number after (0 = first, omit = end). Every other slide is verified unchanged. dry_run=true previews the change on a copy without touching the file. Use for a new blank slide in an existing deck. To copy a slide use keynote_duplicate_slide; for a whole new deck use keynote_build_deck.

Inputs: path (required), after, dry_run. Returns: object

keynote_add_tableKeynote: add tableA
Destructive

Add a table to a slide (1-based). rows = [["Region", "Q1"], ["Riyadh", 1200], …]: text, numbers, or null; text starting with "=" is a formula. kit (iwork_list_design_kits name or your own) styles it: header band, fonts (Arabic-aware), banding, numbers right-aligned. Optional x, y (points from top-left) and width. Every cell, font and colour is read back; other slides and tables are checked untouched. At most 50 rows × 15 columns. dry_run=true previews the change on a copy without touching the file. Needs macOS + Keynote. Use for a table on an existing slide. In a new deck, put it in keynote_build_deck's outline; to show a trend use keynote_add_chart.

Inputs: path (required), rows (required), slide (required), x, +5 more. Returns: object

keynote_apply_designKeynote: apply designA
Destructive

Make a deck look designed: the kit's theme (optional), then every slide's title and body fonts (Arabic-aware), sizes from a type scale, and colours from a contrast-checked palette. kit = a name from iwork_list_design_kits or your own {"fonts": {...}, "colors": {...}}. Text is verified unchanged. dry_run=true previews the change on a copy without touching the file. Use to restyle a whole deck from a kit. For one text item use keynote_format_text. Preview with dry_run, then run keynote_review_deck.

Inputs: path (required), kit, dry_run, set_theme. Returns: object

keynote_build_deckKeynote: build deckA
Destructive

Build a new Keynote deck from an outline. slides = [{"title": "…", "body": ["bullet", "bullet"], "layout": "Title & Bullets", "notes": "…", "image": "/path/pic.png"}, …]; the first slide defaults to a title layout, the rest to Title & Bullets. theme from keynote_list_themes; optional transition for every slide (e.g. dissolve). Every slide is read back and checked; on any mismatch the new file is removed. Never overwrites. kit = a design kit (iwork_list_design_kits) for a designed deck in one call. Chart slides: add "chart": {"type": "bar", "rows": ["2025", "2026"], "columns": ["Q1", "Q2"], "data": [[1, 2], [3, 4]]} or {"type": "line", "from": "/path/report.numbers", "columns": ["Q1", "Q2"]} (header row → column names, first column → row names); chart slides default to Title Only. Table slides: "table": {"rows": [["Region", "Q1"], ["Riyadh", 1200]]} or {"from": "/path/report.numbers", "columns": ["Q1"], "max_rows": 8}; with a kit the table is styled too. Needs macOS + Keynote. Use for a new deck from an outline, including chart and table slides; then run keynote_review_deck. To change an existing deck use the slide and text tools instead.

Inputs: path (required), slides (required), kit, theme, +1 more. Returns: object

keynote_delete_slideKeynote: delete slideA
Destructive

Delete slide number slide (1-based). Recoverable with iwork_restore_backup. dry_run=true previews the change on a copy without touching the file. Use to remove a slide for good (the last slide can't be deleted). To keep it but hide it in the slideshow use keynote_skip_slide.

Inputs: path (required), slide (required), dry_run. Returns: object

keynote_duplicate_slideKeynote: duplicate slideA
Destructive

Duplicate slide number slide (1-based); the copy lands right after it. dry_run=true previews the change on a copy without touching the file. Use to copy an existing slide (layout and content). For a blank slide use keynote_add_slide.

Inputs: path (required), slide (required), dry_run. Returns: object

keynote_format_textKeynote: format textA
Destructive

Font (PostScript name, e.g. "HelveticaNeue-Bold"), size (pt) and/or colour ("#RRGGBB") of one text item on a slide — pick it by item index (from keynote_inspect_style) or by a unique piece of its text (match). Alignment and shape fill are not scriptable. dry_run=true previews the change on a copy without touching the file. Use for one text item's font, size or colour. To restyle the whole deck consistently use keynote_apply_design.

Inputs: path (required), slide (required), font, item, +4 more. Returns: object

keynote_inspect_styleKeynote: inspect styleA
Read-onlyIdempotent

A deck's styling: current theme, available slide layouts, and per slide its layout plus each text item's text, font, size and colour. Read this before theming. Use before formatting: theme, layouts, and each text item's font, size and colour. For slide text and notes use keynote_list_slides.

Inputs: path (required). Returns: object

keynote_list_slidesKeynote: list slidesA
Read-onlyIdempotent

Every slide with its text, presenter notes and whether it is hidden (via Keynote). Use slide numbers from here for slide operations. Use before slide operations to see slide numbers, text, notes and hidden state. For fonts and layouts use keynote_inspect_style.

Inputs: path (required). Returns: object

keynote_list_themesKeynote: list themesA
Read-onlyIdempotent

Themes available in Keynote on this Mac (names to pass to keynote_set_theme). Use before keynote_set_theme or keynote_build_deck to get valid theme names.

Inputs: no named parameters. Returns: object

keynote_move_slideKeynote: move slideA
Destructive

Move slide number slide so it ends up at position to (both 1-based). dry_run=true previews the change on a copy without touching the file. Use to reorder slides. To copy a slide to a new position, duplicate it first with keynote_duplicate_slide.

Inputs: to (required), path (required), slide (required), dry_run. Returns: object

keynote_replace_textKeynote: replace textA
Destructive

Find/replace text across every slide of a .key deck (literal unless regex=true). Formatting and structure are verified unchanged. dry_run=true previews the change on a copy without touching the file. Use to change the same text everywhere in a deck (names, dates, numbers). To rewrite one slide's title or body use keynote_set_slide_text.

Inputs: find (required), path (required), replace (required), regex, +1 more. Returns: object

keynote_review_deckKeynote: review deckA
Read-onlyIdempotent

Design review of a deck as Keynote actually draws it: renders to PDF and reports, per slide, text drawn off the slide or past the bottom of its box (errors), text boxes drawn on top of each other, text under 18 pt, and slides that are too dense (warnings). Run it after building or restyling a deck, fix the errors, then look at a flagged slide with keynote_slide_image. The file isn't changed. Needs macOS + Keynote. Use after building or restyling a deck, before saying it's done; fix every error. To look at a flagged slide use keynote_slide_image; to check one word renders use iwork_verify_render.

Inputs: path (required). Returns: object

keynote_set_presenter_notesKeynote: set presenter notesA
Destructive

Set the presenter notes of slide number slide (1-based). Arabic-safe. dry_run=true previews the change on a copy without touching the file. Use for speaker notes on an existing slide. For a new deck, put notes in keynote_build_deck's outline instead.

Inputs: path (required), notes (required), slide (required), dry_run. Returns: object

keynote_set_slide_layoutKeynote: set slide layoutA
Destructive

Change one slide's layout (master), e.g. "Title & Bullets". Other slides are verified untouched. dry_run=true previews the change on a copy without touching the file. Use to change one slide's layout (names from keynote_inspect_style). Not for text styling: use keynote_format_text.

Inputs: path (required), slide (required), layout (required), dry_run. Returns: object

keynote_set_slide_textKeynote: set slide textA
Destructive

Fill a slide's title and/or body box (body may be a list of bullet lines). The title box is the top-most text box, the body the largest other one. Other slides and text boxes are verified untouched. dry_run=true previews the change on a copy without touching the file. Use to fill or rewrite one slide's title and body. To change the same words across the deck use keynote_replace_text; for speaker notes use keynote_set_presenter_notes.

Inputs: path (required), slide (required), body, title, +1 more. Returns: object

keynote_set_themeKeynote: set themeA
Destructive

Apply a different Keynote theme to the whole deck. Rolled back if any slide loses text. dry_run=true previews the change on a copy without touching the file. Use to switch the deck's theme only. For a full designed look (fonts, sizes, colours) use keynote_apply_design, which can set the theme too.

Inputs: path (required), theme (required), dry_run. Returns: object

keynote_set_transitionKeynote: set transitionA
Destructive

Transition into a slide: effect such as dissolve, push, wipe, magic move, cube, flip, move in, reveal, "none"; duration/delay in seconds; automatic=true advances on its own. Other slides verified untouched. dry_run=true previews the change on a copy without touching the file. Use for one slide's transition. For the same transition on every slide of a new deck, pass transition= to keynote_build_deck.

Inputs: path (required), slide (required), effect (required), delay, +3 more. Returns: object

keynote_skip_slideKeynote: skip slideA
Destructive

Hide (skipped=true) or show a slide in the slideshow. dry_run=true previews the change on a copy without touching the file. Use to hide or show a slide in the slideshow without deleting it. To remove it use keynote_delete_slide.

Inputs: path (required), slide (required), dry_run, skipped. Returns: object

keynote_slide_imageKeynote: slide imageA
Read-onlyIdempotent

One slide as an image (JPEG, width px wide), exported by Keynote, so you can look at the design yourself. Skipped slides aren't exported. The file isn't changed. Needs macOS + Keynote. Use to look at a slide's real rendering, e.g. one keynote_review_deck flagged. For a quick preview without Keynote use iwork_thumbnail (first slide, last saved state).

Inputs: path (required), slide (required), width.

keynote_slideshowKeynote: slideshowA
Read-onlyIdempotent

Present: action = start (needs path; from_slide 1-based) | stop | next | previous. Doesn't change the file. Needs macOS + Keynote. Use to present the deck live; it doesn't change the file. To share it instead use iwork_export.

Inputs: action (required), path, from_slide. Returns: object

numbers_add_tableNumbers: add tableA
Destructive

Add a table with data to an existing sheet (sheet, default the first) or to a new sheet (new_sheet). Every existing table is verified unchanged. dry_run=true previews the change on a copy without touching the file. Use for a new, separate table on a sheet or a new sheet. To grow an existing table use numbers_insert.

Inputs: path (required), rows (required), table_name (required), sheet, +4 more. Returns: object

numbers_apply_designNumbers: apply designA
Destructive

Style a whole table from a design kit: header band (fill, bold, contrast-checked text), body font and colour (Arabic cells get the Arabic font), alternate-row banding, number columns right-aligned. Values never change; every other table is verified untouched. No app needed. dry_run=true previews the change on a copy without touching the file. Use to make a whole table look designed in one call (header band, fonts, banding, aligned numbers). For a few cells use numbers_set_cell_style. Preview with dry_run.

Inputs: path (required), kit, sheet, table, +2 more. Returns: object

numbers_createNumbers: createA
Destructive

Create a new .numbers file from data. sheets = [{"name": "Sales", "tables": [{"name": "Q1", "rows": [["Region", "Revenue"], ["Riyadh", 1200]], "header_rows": 1}]}]. Numbers stay numbers, text stays text exactly (Arabic included). Refuses to overwrite. No app needed. Use to make a new Numbers file when you have the rows. From a CSV file use numbers_import_csv; to add a table to an existing file use numbers_add_table.

Inputs: path (required), sheets (required). Returns: object

numbers_deleteNumbers: deleteA
Destructive

Delete count rows or columns (what = rows | columns) starting at 1-based position at. Remaining cells are verified. Refused in tables with formulas or merged cells. Undo with iwork_restore_backup. dry_run=true previews the change on a copy without touching the file. Use to remove rows or columns. Not for clearing values (use numbers_edit_cell with null). Refused in tables with formulas or merges; undo with iwork_restore_backup.

Inputs: at (required), path (required), what (required), count, +3 more. Returns: object

numbers_edit_cellNumbers: edit cellA
Destructive

Set one cell (e.g. ref "B2") in a .numbers file. Backed up, verified, atomic; every other cell is checked unchanged. dry_run=true previews the change on a copy without touching the file. Use to set one value. For a formula use numbers_set_formula; to add whole rows use numbers_insert with values; for how a number displays use numbers_set_number_format.

Inputs: ref (required), path (required), value (required), sheet, +2 more. Returns: object

numbers_import_csvNumbers: import csvA
Destructive

Turn a CSV/TSV into a new .numbers file (UTF-8, delimiter auto-detected). Plain numbers become numbers (numbers=false keeps everything as text); dates, "$1,234" and Arabic-Indic digits stay text exactly as written. Refuses to overwrite. Use when the data is in a CSV/TSV file. When you already have the rows use numbers_create.

Inputs: path (required), csv_path (required), sheet, table, +3 more. Returns: object

numbers_insertNumbers: insertA
Destructive

Insert rows or columns (what = rows | columns) before 1-based position at; omit at to append. Optional values: one list per new row (or column). Every existing cell is verified at its new position. In tables with formulas, only appending is allowed (shifting would break references). dry_run=true previews the change on a copy without touching the file. Use to add rows or columns to an existing table (optionally filled). For a separate table use numbers_add_table. In tables with formulas only appending works; do mid-table inserts in Numbers.

Inputs: path (required), what (required), at, count, +4 more. Returns: object

numbers_inspect_formatNumbers: inspect formatA
Read-only

Current formatting of a Numbers table: column widths, row heights, header rows/cols, merges, and per-cell font/colour/fill/alignment, number format (shown_as) and borders. Read this before formatting. Use before formatting to see current styles, number formats, sizes, headers and merges. For values use iwork_read.

Inputs: path (required), sheet, table. Returns: object

numbers_merge_cellsNumbers: merge cellsA
Destructive

Merge a rectangular range ("A1:C1"). Refused if any cell other than the top-left holds data (it would be hidden) or the range crosses the header edge. dry_run=true previews the change on a copy without touching the file. Use to merge a range, e.g. a title across columns. Refused if it would hide values; avoid merging inside data you will sort.

Inputs: path (required), cells (required), sheet, table, +1 more. Returns: object

numbers_recalculateNumbers: recalculateA
Destructive

Make Numbers recompute every formula from the current values. Numbers keeps showing a formula's old result after edits made without it (numbers_edit_cell, numbers_insert…), so run this after those when the file has formulas — their result says so (formulas_need_recalc). Formulas and inputs are verified unchanged. Needs macOS + Numbers, file closed. dry_run=true previews the change on a copy without touching the file. Use only after a no-app edit returned formulas_need_recalc, so totals are current. Not needed after numbers_set_formula, which recalculates itself.

Inputs: path (required), dry_run. Returns: object

numbers_set_bordersNumbers: set bordersA
Destructive

Cell borders on a range: sides = all | outline | inner | top | right | bottom | left; width in points; color "#RRGGBB"; style = solid | dashes | dots | none. dry_run=true previews the change on a copy without touching the file. Use for lines around or inside a range. For fills and fonts use numbers_set_cell_style.

Inputs: path (required), cells (required), color, sheet, +5 more. Returns: object

numbers_set_cell_styleNumbers: set cell styleA
Destructive

Style a range ("A1:D1"): font_name, font_size, bold, italic, underline, strikethrough, font_color / fill_color as "#RRGGBB", align (left|center|right|justify|auto), valign (top|middle|bottom), wrap. Only the attributes you pass change; every other cell is verified untouched. dry_run=true previews the change on a copy without touching the file. Use for fonts, colours, fill or alignment on a few cells. For a whole table that should look designed use numbers_apply_design; for how numbers display use numbers_set_number_format.

Inputs: path (required), cells (required), bold, wrap, +12 more. Returns: object

numbers_set_dimensionsNumbers: set dimensionsA
Destructive

Set column widths and/or row heights in points, e.g. columns={"A": 160, "C": 90}, rows={"1": 32} (rows are 1-based). Nothing else changes. dry_run=true previews the change on a copy without touching the file. Use for column widths and row heights. To change which rows count as headers use numbers_set_headers.

Inputs: path (required), rows, sheet, table, +2 more. Returns: object

numbers_set_formulaNumbers: set formulaA
Destructive

Put a formula in one cell, e.g. ref "D10", formula "=SUM(D2:D9)"; Numbers computes it and the result is returned. Every other cell's input is verified unchanged. Needs macOS + Numbers, file closed. dry_run=true previews the change on a copy without touching the file. Use for a cell that calculates (=SUM…); Numbers computes the result. For a plain value use numbers_edit_cell. Needs the Numbers app.

Inputs: ref (required), path (required), formula (required), sheet, +2 more. Returns: object

numbers_set_headersNumbers: set headersA
Destructive

Set how many header rows / header columns a table has (0–5). dry_run=true previews the change on a copy without touching the file. Use when the user wants a different number of header rows or columns, e.g. to freeze a title row on top for sorting and styling. Not for sizes (numbers_set_dimensions) or header colours (numbers_set_cell_style or numbers_apply_design).

Inputs: path (required), sheet, table, dry_run, +2 more. Returns: object

numbers_set_number_formatNumbers: set number formatA
Destructive

How numbers display in a range ("B2:B9"): format = number | currency | percentage | scientific | fraction | datetime | text. Options: decimal_places, thousands_separator, negative_style (minus|red|parentheses|red_parentheses), currency_code (ISO, e.g. SAR, USD), accounting, date_format (e.g. "d MMM yyyy"). Values are not changed; the result shows how each cell now displays. dry_run=true previews the change on a copy without touching the file. Use for how numbers display (currency, %, dates, decimals); the values don't change. For fonts and colours use numbers_set_cell_style.

Inputs: path (required), cells (required), format (required), sheet, +8 more. Returns: object

numbers_sortNumbers: sortA
Destructive

Sort a table's body rows by a column letter (header rows stay on top). Verified as a pure reorder. A table whose formulas read other rows (e.g. =B2*0.1 below a base-figure row) is refused, because Numbers' sort would break them; for it, to_new_table=true leaves the table, its formulas and its charts as they are and puts a sorted copy of its values (no formulas) in a new table on the same sheet (named new_table_name, default " sorted"). Chart the copy with keynote_build_deck. Needs macOS + Numbers, file closed. dry_run=true previews the change on a copy without touching the file. Use to reorder body rows by one column; header rows stay on top. If it refuses because formulas read other rows, call it again with to_new_table=true for a sorted copy; never rewrite the formulas to force it. Needs the Numbers app.

Inputs: path (required), column (required), sheet, table, +4 more. Returns: object

pages_fill_placeholdersPages: fill placeholdersA
Destructive

Fill template placeholders by tag, e.g. {"Name": "Sara", "Date": "3 October"}. Formatting is kept; the body is verified to change only there. Needs macOS + Pages. dry_run=true previews the change on a copy without touching the file. Use for template fields (Name, Date). It's the only write for page-layout documents like letters and flyers, which have no body text.

Inputs: path (required), values (required), dry_run. Returns: object

pages_list_placeholdersPages: list placeholdersA
Read-onlyIdempotent

Template placeholders in a .pages document (tag + current text), e.g. a letter's "Name" or "Date" fields. Needs macOS + Pages. Use before pages_fill_placeholders to see the template's field tags.

Inputs: path (required). Returns: object

pages_preflightPages: check it can answerA
Read-onlyIdempotent

Check Pages can answer AppleEvents. Run once before any Pages op; never loop on failure. Call once before other Pages tools. A -1712 error means a dialog in Pages needs a human; don't retry until it's dismissed.

Inputs: no named parameters. Returns: object

pages_read_tablesPages: read tablesA
Read-onlyIdempotent

Every table in a .pages document: name, size, and each cell's value, shown text and formula. Needs macOS + Pages. Use before pages_set_table_cells to see the tables, their names and cell references.

Inputs: path (required). Returns: object

pages_replace_allPages: replace allA
Destructive

Replace every occurrence of find in a .pages body (needs Pages + GUI session). Rolled back if the readback disagrees. dry_run=true previews the change on a copy without touching the file. Use to change text everywhere while keeping formatting. To replace the whole body use pages_set_body; for template fields use pages_fill_placeholders.

Inputs: find (required), path (required), replace (required), dry_run. Returns: object

pages_set_bodyPages: set bodyA
Destructive

Replace the entire body text of a .pages document (needs Pages + GUI session). Body formatting is reset. dry_run=true previews the change on a copy without touching the file. Use only to replace the entire body text; it resets body formatting, so warn the user. Prefer pages_replace_all or pages_fill_placeholders.

Inputs: body (required), path (required), dry_run. Returns: object

pages_set_table_cellsPages: set table cellsA
Destructive

Write cells of an existing table in a .pages document. table = its name or number (from pages_read_tables); cells = {"B2": 1200, "C3": "تم", "D9": "=SUM(D2:D8)"} — numbers stay numbers, "=…" makes a formula, null clears. Every other cell and the body text are verified unchanged. New tables can't be created (Pages 15 doesn't script it). Needs macOS + Pages, document closed. dry_run=true previews the change on a copy without touching the file. Use to write into an existing Pages table. New tables can't be created in Pages; for text outside tables use pages_replace_all.

Inputs: path (required), cells (required), table (required), dry_run. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 65 tools

    Disambiguation4/5

    Despite 65 tools, nearly every description explicitly cross-references its neighbors (e.g. 'to check text is present use iwork_verify_render', 'for a whole table use numbers_apply_design'), which sharply delineates read/verify/format/style/write roles. A few clusters remain genuinely easy to confuse: five ways to create files (iwork_create, iwork_create_from_template, numbers_create, numbers_import_csv, keynote_build_deck), three design-kit creation paths, and verify_render vs verify_format, thumbnail vs slide_image.

    Naming Consistency4/5

    Strong, predictable prefix_namespace + verb_noun scheme throughout (numbers_set_*, keynote_add_*, pages_*_*, iwork_*), making tools self-locating. Minor deviations exist where the noun is dropped for verb-only tools (numbers_recalculate, numbers_sort, pages_preflight) or noun-only tools (iwork_samples, iwork_capabilities), but these are few and still readable.

    Tool Count2/5

    At 65 tools this is well into 'heavy' territory for an agent to navigate in a single surface. While each tool does earn its place within the broad three-app domain (Numbers, Keynote, Pages), the total volume risks selection errors and context bloat.

    Completeness4/5

    Covers the full lifecycle across three apps: create/read/edit/format/verify/export plus versioned backups and restore. Gaps are minor and mostly app-imposed limitations (Pages cannot create tables or style fonts, Pages/Keynote lack review/comment features), which the descriptions acknowledge.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      An MCP server that provides 113 tools for automating Apple iWork apps (Numbers, Pages, Keynote) via JavaScript for Automation, enabling AI assistants to create, edit, and export documents, spreadsheets, and presentations.
      1
      263 npm
      45
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables complete Office document lifecycle management for AI agents, including creation, editing, conversion, and templating of DOCX, XLSX, PPTX, PDF, and EML files.
      40
      55 PyPI
      MIT