iWork Studio

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.

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

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.

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

⚡ = 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.

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 colum