pages

name

pages

description

Control Apple Pages documents from Claude. Create, edit, format, review, and export Pages documents programmatically. Trigger: "/pages", "pages document", "create pages document", "write letter in pages", "report in pages", "export pages", "open pages file", "format document in pages", "pages erstellen", "pages dokument", "brief schreiben in pages". Use this skill when the user wants to create, edit, format, review, or export a Pages document. Supports 100+ templates, text styling, tables, images, export to PDF/Word/EPUB/text.

Apple Pages CLI Skill

Control Apple Pages from Claude — create, edit, format, review, and export documents.

Prerequisites

The pages-cli command must be installed. If not available, install it automatically:

which pages-cli || (cd ${CLAUDE_PLUGIN_ROOT}/agent-harness && python3 -m venv .venv && source .venv/bin/activate && pip install -e . && echo "pages-cli installed")

If a venv already exists, activate it:

test -f ${CLAUDE_PLUGIN_ROOT}/agent-harness/.venv/bin/activate && source ${CLAUDE_PLUGIN_ROOT}/agent-harness/.venv/bin/activate

System requirements:

• macOS (Apple Pages is macOS-only)
• Apple Pages installed (pre-installed or from the App Store)
• Python 3.10+

Command Syntax

Command	Action
/pages new	Create a new blank document
/pages new <template>	Create document from template
/pages open <path>	Open an existing document
/pages info	Show document info
/pages close	Close document
/pages export pdf <path>	Export as PDF
/pages export word <path>	Export as Word
/pages templates	List available templates
/pages status	Show session status

CLI Command Reference

Document management:

pages-cli --json document new
pages-cli --json document new --template "Professional Report"
pages-cli --json document open "/path/to/document.pages"
pages-cli --json document info
pages-cli --json document list
pages-cli document save
pages-cli document save --path "/path/to/save.pages"
pages-cli document close
pages-cli document close --no-save

Text:

pages-cli text add "New text"
pages-cli text set "Replace entire body text"
pages-cli --json text get
pages-cli text set-font --name "Helvetica Neue" --size 14
pages-cli text set-font --name "Helvetica Neue" --size 24 --paragraph 1
pages-cli text set-color --r 0 --g 0 --b 65535 --paragraph 1
pages-cli --json text word-count

Tables:

pages-cli table add --rows 5 --cols 3 --name "Data"
pages-cli table set-cell "Data" 1 1 "Column A"
pages-cli --json table get-cell "Data" 1 1
pages-cli --json table list
pages-cli table merge "Data" "A1:B1"
pages-cli table sort "Data" --column 1

Media:

pages-cli media add-image "/path/to/image.png" --x 100 --y 200
pages-cli media add-shape --type rectangle --w 200 --h 100 --text "Box"
pages-cli --json media list

Export:

pages-cli export pdf ~/Desktop/document.pdf
pages-cli export word ~/Desktop/document.docx
pages-cli export epub ~/Desktop/book.epub --title "Title" --author "Author"
pages-cli export text ~/Desktop/document.txt
pages-cli export rtf ~/Desktop/document.rtf
pages-cli --json export formats

Templates & session:

pages-cli --json template list
pages-cli --json session status

Natural Language → CLI Mapping

Translate user instructions into CLI commands:

User says	CLI command
"Write a title"	text add "Title" + text set-font --size 24 --paragraph N
"Make the text bigger"	text set-font --size 16
"Add a table"	table add --rows N --cols N
"Insert this image"	media add-image "path"
"Export as PDF"	export pdf ~/Desktop/output.pdf
"How many words?"	--json text word-count
"Show me the text"	--json text get
"Review the document"	--json text get → analyze + suggest improvements

Colors (RGB 0-65535)

Pages uses RGB values from 0-65535 (not 0-255):

• Black: --r 0 --g 0 --b 0
• Red: --r 65535 --g 0 --b 0
• Blue: --r 0 --g 0 --b 65535
• Green: --r 0 --g 65535 --b 0

Conversion: Pages value = round((RGB_0_255 / 255) * 65535)

Available Templates (Selection)

• Blank: Blank, Blank Landscape, Blank Black
• Reports: Simple Report, Modern Report, Professional Report, Research Paper
• Letters: Classic Letter, Professional Letter, Modern Letter, Business Letter
• CVs: Contemporary CV, Classic CV, Professional CV, Modern CV
• Newsletters: Classic Newsletter, Simple Newsletter
• Posters/Flyers: Photo Poster, Event Poster, Type Poster
• Cards: Birthday Card, Photo Card, Party Invitation
• Custom: All user-saved custom templates in Pages

Full list: pages-cli --json template list

Important

• ALWAYS use --json for query commands (info, list, get, status, word-count)
• Pages launches automatically if not already running
• If CLI is not in PATH: source ${CLAUDE_PLUGIN_ROOT}/agent-harness/.venv/bin/activate