iWork Studio MCP Server
An MCP server for safely reading, creating, and editing Apple iWork files (Numbers, Keynote, Pages) with backups, verification, and undo.
Read any
.numbers,.key, or.pagesfile into JSON, plus metadata, thumbnails, and Spotlight-based file search.Create Numbers files from rows or CSV, Keynote decks from outlines (with chart/table slides), and Pages/Numbers/Keynote files from built-in templates or your own files.
Edit Numbers: cells, formulas, recalculate, insert/delete rows and columns, add tables/sheets, sort.
Format Numbers: fonts, colors, fills, alignment, number/currency/percent/date formats, borders, dimensions, headers, merges, and one-call design kits.
Edit Keynote: replace text, set slide title/body, add/duplicate/delete/move/skip slides, presenter notes, themes, layouts, transitions, images, charts, and styled tables.
Build and restyle Keynote decks from outlines or design kits, then review rendered design (overflow, overlaps, small text) and export slides as images.
Edit Pages: replace text, set body, fill template placeholders, read/write existing tables.
Export to PDF, Excel, CSV, Word, EPUB, TXT, RTF, PowerPoint, images, or movie (with optional passwords).
Verify output by checking that text actually renders and that fonts/sizes/colors/pages match.
Stay safe: automatic versioned backups, atomic writes, dry-run previews, rollback on mismatch, refusal of risky operations, and one-call undo via backup restore.
Manage design kits: list presets, extract a brand kit from an existing file, save/delete custom kits.
Present Keynote slideshows (start/stop/next/previous).
Provides tools for reading, creating, editing, formatting, theming, reviewing, and exporting Apple Numbers, Keynote, and Pages documents. It can manage spreadsheet cells, formulas, tables and charts; Keynote slides, layouts, transitions, presenter notes and images; and Pages body text, placeholders and existing tables, with exports to PDF, Office formats, CSV, EPUB, RTF and more.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@iWork Studio MCP Server Turn sales.csv into a Numbers file and add a bold header with a total row"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
Claude desktop app (Mac, from Terminal) | Paste in Terminal: |
Claude Code, as a plugin (tools + skill) |
|
Claude Code, tools only |
|
Hermes Agent (tools + skill) |
|
Cursor, VS Code, Codex, any MCP client |
|
That's it. The installer sets up uv if needed, and uv brings its own Python.
Fence it (recommended):
… | sh -s -- --roots ~/Documents ~/Desktoplimits it to those folders. Other clients: setIWORK_STUDIO_ROOTS(:-separated).Load less (optional): only work in Keynote? Set
IWORK_STUDIO_TOOLSETS=keynote,design(any offiles,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 inAGENTS.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_sortwithto_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 |
| Calm and corporate: slate neutrals, one blue accent |
| Trust and weight: deep navy, restrained gold |
| Formal reports and boards: serif headings, navy and amber |
| Fresh and confident: deep teal |
| Data-forward: strong blue, amber highlights |
| 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 whyBackup first, versioned and private: in
~/.iwork-studio/backups/(orIWORK_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 |
| What this machine can do: apps, GUI session, which routes work |
| Any |
| Find iWork files by kind and name (Spotlight on a Mac) |
| Copy sample files (synthetic sales data, English and Arabic) to try it with nothing of your own |
| Template, app builds, format version, slide count · the stored preview image |
| New file from Apple's built-in templates · copy of your own file |
| Built-in templates (Numbers, Pages) and themes (Keynote) |
| Design kits: fonts, palettes, type scale — presets and your saved kits |
| A kit from your own deck or table: its fonts and colours; save it by name |
| Keep your brand kit by name · remove one |
| PDF, Excel, CSV, Word, EPUB, text, RTF, PowerPoint, slide images, movie; optional password |
| Rendered PDF shows this text · with this font, size, colour, page size |
| Undo |
Tool | What it does |
| New file from rows of data · from a CSV/TSV |
| Set one cell |
| Put a formula in a cell; Numbers computes it |
| Have Numbers recompute every formula after edits made without it |
| Rows or columns, anywhere |
| New table on a sheet, or on a new sheet |
| Sort body rows by a column. A table whose formulas read other rows is refused, since Numbers' sort would break them; |
| Widths, heights, headers, merges, and every cell's style, number format and borders |
| Font, size, bold/italic/underline/strike, colours, fill, alignment, wrap |
| Number, currency (any ISO code), %, scientific, fraction, date, text; decimals, separators, negatives |
| All / outline / inner / one side; width, colour, style |
| Column widths and row heights · header rows/columns · merges |
Tool | What it does |
| A new deck from an outline: titles, bullets, notes, images, chart and table slides, transition, design kit |
| Design review of the rendered deck: off-slide and overflowing text, overlaps, small text, crowded slides |
| One slide as an image, to look at |
| Fill a slide's title and body |
| Restyle every slide from a design kit |
| Find/replace on every slide, formatting untouched |
| Every slide's text, notes, hidden state and chart count |
| Slide operations |
| Presenter notes |
| Available themes · a deck's theme, layouts and text styling |
| Theme · one slide's layout · one text item's font, size, colour |
| Effect, duration, delay, auto-advance |
| Place an image on a slide |
| Add a bar, line, area, pie or scatter chart from data |
| Add a table, styled from a design kit; every cell is read back |
| Start, stop, next, previous |
Tool | What it does |
| Checks Pages can answer (run once first) |
| Replace text everywhere · replace the whole body (resets its formatting) |
| Template fields like Name and Date |
| 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 viaCLAUDE.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, orbash skill-pack/install.shfor 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.12from 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"])save in <path>is denied by the iWork sandbox. In-placesaveandexportwork. →sandbox-trap.mdKeynote's slide
title/bodyproperties throw-1700. Use the text item'sobject text. →keynote-1700-defect.mdChart 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.
Byte-equal saves don't exist in iWork's format. The real bar is semantic: it reopens, and the full model matches.
First-run permission and template-chooser dialogs block every script call. A preflight turns the hang into one clear prompt. →
tcc-preflight.md"Creator Studio" apps have different names. A hardcoded
Application("Numbers")drives the wrong app; names are resolved per call. →apps.pystdout is the MCP wire. Import-time warnings from libraries would corrupt it, so they go to stderr.
Keynote's JavaScript insert and move are broken; AppleScript
make new slideandmove slide … to before slide …work.Keynote master slides can't be reached from JavaScript (
-1700); layouts go through AppleScript.numbers-parser doesn't save in-place style edits. Styles are registered first, then applied.
numbers-parser stored 12 as 12.000000000000002. Decimals are now encoded exactly.
numbers-parser doesn't update formula references when rows move, so mid-table inserts in formula tables are refused.
Keynote colours are 0–65535 per channel, not 0–255 or 0–1.
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.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.
The Pages sandbox refuses AppleScript
openfor files outside it; JavaScriptopenis allowed, so documents are opened that way and then found by their exact path.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.
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_recalculatehas Numbers recompute every formula.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.
Don't keep the repo in iCloud Drive. Sync creates "main 2" copies inside
.git.Keynote creates tables only one way:
tell slide n to make new tableworks, whilemake new table at end of tables of slide nand 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 modelsrc/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 appContributing
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 openediWork 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 toolsiwork_capabilitiesWhat this Mac can doARead-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 templateADestructive
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 fileADestructive
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 kitADestructive
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…)ADestructive
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 kitAIdempotent
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 filesARead-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 backupsARead-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 kitsARead-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 templatesARead-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 detailsARead-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 fileARead-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 backupADestructive
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 tryAIdempotent
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 kitAIdempotent
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 imageARead-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 formattingARead-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 renderedARead-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 chartADestructive
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 imageADestructive
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 slideADestructive
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 tableADestructive
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 designADestructive
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 deckADestructive
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 slideADestructive
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 slideADestructive
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 textADestructive
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 styleARead-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 slidesARead-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 themesARead-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 slideADestructive
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 textADestructive
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 deckARead-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 notesADestructive
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 layoutADestructive
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 textADestructive
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 themeADestructive
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 transitionADestructive
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 slideADestructive
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 imageARead-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: slideshowARead-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 tableADestructive
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 designADestructive
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: createADestructive
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: deleteADestructive
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 cellADestructive
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 csvADestructive
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: insertADestructive
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 formatARead-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 cellsADestructive
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: recalculateADestructive
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 bordersADestructive
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 styleADestructive
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 dimensionsADestructive
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 formulaADestructive
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 headersADestructive
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 formatADestructive
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: sortADestructive
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 placeholdersADestructive
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 placeholdersARead-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 answerARead-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 tablesARead-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 allADestructive
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 bodyADestructive
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 cellsADestructive
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
Scored across 65 tools
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.
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.
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.
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
Related MCP Connectors
Convert, create and edit Word, PowerPoint, Excel and PDF documents from any AI agent.
Create and manage documents, spreadsheets, and presentations from your AI assistant.
Productivity toolbox for Personal Agents: create PPTs, covers, websites, music and process files.
Online office suite for AI agents: edit docs, sheets, slides and PDFs in browser or via MCP.
Related MCP Servers
- AlicenseBqualityBmaintenanceAn 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.1263 npm45MIT
- AlicenseBqualityCmaintenanceEnables complete Office document lifecycle management for AI agents, including creation, editing, conversion, and templating of DOCX, XLSX, PPTX, PDF, and EML files.4055 PyPIMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to create and manipulate Microsoft Office documents (PowerPoint, Word, Excel) on macOS via AppleScript automation.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to read, create, edit Word/Excel/PPT files and manage the filesystem on the user's computer via natural language.MIT