InDesign MCP Server

Turn Adobe InDesign into an AI design automation platform — 420+ MCP tools for documents, layout, typography, styles, tables, images, long documents, interactive documents, prepress, and PDF and EPUB export. Drive InDesign from Claude, Cursor, Warp, or any MCP client using natural language.
Why this exists
Design ops still means repeating the same layout chores by hand. This server exposes InDesign as structured tools an agent can call: create pages, place assets, apply brand styles, export PDF — without leaving the chat.
Perfect for
- Design teams automating layout tasks and brand consistency
- Content creators generating documents at scale
- AI assistants that need real InDesign control
- Developers building design automation workflows
- Publishers streamlining production
Key features
Core
- Document management — create, open, save, close, preferences, preflight, XML
- Page management — add, delete, duplicate, move, guides, navigation
- Content — text frames, tables, find/replace, shapes, images
- Styles — paragraph, character, object styles and color swatches
- Layout — spreads, master spreads, layers, groups, page items, guides and grids
- Export — PDF, JPEG/PNG images, EPUB (reflowable or fixed layout), package for print
- Books — multi-document books, sync, repaginate, cross-references
Module areas
Each area covers the panels and dialogs of one part of InDesign, mapped feature by feature to the capability atlas:
- Typography — character and paragraph formatting, OpenType, bullets and numbering, GREP styles, tabs, CJK composition
- Styles — paragraph, character, object, table, cell and TOC styles, style groups, Quick Apply, nested styles
- Text frames, tables and long documents — text frame options, wrap, notes and track changes, threading; table and cell options; tables of contents, footnotes, index, conditional text, hyperlinks, cross-references, text variables and books
- Frames, paths and layout — shapes, strokes, anchored objects, libraries, transformations, pathfinder, alternate and liquid layouts, flex layouts, linked content, guides and grids
- Colour, effects and images — swatches, gradients, mixed inks, colour settings and proofing, effects and transparency, links and import options
- Output — PDF, EPUB and HTML export with every option, Word and Excel import, printing, preflight, separations, booklets and packaging
- Interactive documents, XML, data merge — buttons and forms, object states, animation, media; XML structure, tags and import/export; data merge, find and change, dictionaries and languages
- Documents, pages and preferences — document presets, pages and spreads, parent pages, layers, selection, undo history, and every Preferences pane
- macOS — AppleScript (
osascript) bridge; InDesign version is auto-detected (or set via INDESIGN_APP_NAME)
- Windows — COM automation via PowerShell (
New-Object -ComObject); tries current and recent InDesign ProgIDs
- UXP (optional) —
INDESIGN_BACKEND=uxp|auto via local bridge + plugin under uxp/
- Session manager — tracks page dimensions and fills in positions and sizes you leave out
- Help tool — parameters for every tool and category, generated from the same definitions as
tools/list
- Safe JSX helpers —
src/utils/jsxSafe.js for validated string/number/path interpolation into ExtendScript
Quick start
Prerequisites
- Adobe InDesign (2023 or later recommended)
- Node.js 18+
- macOS or Windows
macOS
Uses AppleScript. Grant Automation permissions for your terminal/Node if prompted (System Settings → Privacy & Security → Automation).
InDesign version is resolved in order:
INDESIGN_APP_NAME environment variable (e.g. Adobe InDesign 2026)
- A running InDesign process
- Newest
Adobe InDesign *.app under /Applications or ~/Applications
- Fallback:
Adobe InDesign 2025
Windows
Uses COM automation through PowerShell. No extra install steps. InDesign should be installed; the server will attach to a running instance or launch via COM.
Installation
Nothing to clone. MCP clients start the server with npx, which downloads it from npm on first run. It is listed in the official MCP Registry as io.github.zachshallbetter/adobe-mcp-indesign.
Claude Code:
claude mcp add indesign -- npx -y adobe-mcp-indesign
MCP client config
Any other client (Claude Desktop claude_desktop_config.json, Cursor, Warp, …):
{
"mcpServers": {
"indesign": {
"command": "npx",
"args": ["-y", "adobe-mcp-indesign"]
}
}
}
Optional environment overrides:
{
"mcpServers": {
"indesign": {
"command": "npx",
"args": ["-y", "adobe-mcp-indesign"],
"env": {
"INDESIGN_APP_NAME": "Adobe InDesign 2026",
"INDESIGN_ALLOWED_DIRS": "/Users/you/Projects:/Users/you/Documents"
}
}
}
}
INDESIGN_APP_NAME — macOS only; force a specific app name for AppleScript
INDESIGN_ALLOWED_DIRS — extra directories allowed for file operations (delimiter is : on macOS, ; on Windows)
Restart the client, open InDesign, then try: Create an A4 doc and add a centered title.
To run from a clone instead (for development), use "command": "node" with "args": ["/ABSOLUTE/PATH/TO/adobe-mcp-indesign/src/index.js"] after npm install.
Help system
await tools.call("help");
await tools.call("help", { tool: "create_document" });
await tools.call("help", { category: "text" });
await tools.call("help", { format: "detailed" });
await tools.call("help", { format: "examples" });
Example calls
await callTool('create_document', {
width: 210,
height: 297,
pages: 1
});
await callTool('create_text_frame', {
content: 'Hello, InDesign!',
fontSize: 14
});
await callTool('create_paragraph_style', {
name: 'Heading',
fontSize: 24,
alignment: 'CENTER_ALIGN'
});
137 tools in seven areas. The full reference, with every parameter, is docs/TOOLS.md (generated from the same definitions the server advertises).
| Area | Tools | Examples |
|---|
| Documents & books | 46 | create_document, open_document, save_document, preflight_document, data_merge, validate_document, create_book, export_book |
| Pages & spreads | 30 | add_page, resize_page, create_page_guides, place_file_on_page, list_spreads, duplicate_spread |
| Text & tables | 5 | create_text_frame, edit_text_frame, create_table, populate_table, find_replace_text |
| Graphics & images | 8 | place_image, create_rectangle, create_polygon, create_object_style |
| Styles & colors | 8 | create_paragraph_style, create_character_style, create_color_swatch, apply_color |
| Layout, masters & layers | 30 | move_page_item, create_group, create_master_spread, detach_master_items, create_layer |
| Export & utilities | 10 | export_pdf, export_images, export_epub, package_document, indesign_status, execute_indesign_code |
For AI agents
- Instructions at connect. The server sends usage instructions in its
initialize response (units, indexes, colors, fonts, paths, errors), which MCP clients pass to the model.
- Annotations on every tool.
readOnlyHint, destructiveHint, idempotentHint and openWorldHint let clients ask before destructive calls such as delete_page, cleanup_document or close_document (which discards unsaved changes).
- Real errors. A failed call returns
isError: true with a message such as "No document open" or "Error: color swatch 'Brand' not found".
- Self-describing.
help({ tool }) returns any tool's parameters; help({ category }) lists tools by area.
- Conventions. Millimeters from the target page's top-left corner, 0-based indexes, swatch names or
"#RRGGBB", fonts as "Family\tStyle". See docs/LLM_PROMPT.md for workflows.
Session management
The server tracks page dimensions and active document metadata so tools can place content with sensible defaults when coordinates are omitted.
await callTool('get_session_info', {});
await callTool('clear_session', {});
await callTool('create_text_frame', {
content: 'Auto-positioned text',
fontSize: 12
});
Architecture
src/
├── core/
│ ├── InDesignMCPServer.js # MCP server
│ ├── scriptExecutor.js # macOS AppleScript + Windows COM
│ └── sessionManager.js # Session state
├── handlers/ # Tools by domain
│ ├── documentHandlers.js
│ ├── pageHandlers.js
│ ├── textHandlers.js
│ ├── styleHandlers.js
│ ├── graphicsHandlers.js
│ ├── bookHandlers.js
│ ├── pageItemHandlers.js
│ ├── groupHandlers.js
│ ├── masterSpreadHandlers.js
│ ├── spreadHandlers.js
│ ├── layerHandlers.js
│ ├── exportHandlers.js
│ ├── utilityHandlers.js
│ ├── helpHandlers.js
│ └── index.js
├── types/ # Tool definitions
├── utils/
│ ├── stringUtils.js # Response helpers, escapeJsxString
│ └── jsxSafe.js # Validated ExtendScript literals / paths
└── index.js
Script execution
| Platform | Mechanism | Notes |
|---|
| macOS | osascript → do script | App name auto-detected; temp .jsx in OS temp dir |
| Windows | PowerShell COM DoScript | ProgIDs tried newest-first; temp .jsx in OS temp dir |
ExtendScript safety
Tool arguments that flow into JSX should go through src/utils/jsxSafe.js:
str(), num(), bool(), index(), enumOf(), measure(), json(), numList()
validateFilePath() / jsxPath() for filesystem paths (INDESIGN_ALLOWED_DIRS)
Every handler uses these helpers; raw argument strings never reach a script.
Errors
Scripts report failures as text ("No document open", "Error …", "… not found"). The server recognizes these (looksLikeFailure in src/utils/stringUtils.js) and returns them with success: false and MCP isError: true, so clients can tell a failed call from a successful one.
Real-world applications
- Automated report generation with consistent styles
- Brand asset and template systems
- Multi-page publications and books
- Design-system driven layout
Testing
npm run check
npm test
npm run test:audit
npm run test:integration
npm run test:unified
npm test covers:
- Tool definitions: every tool has a description, title, annotations and a typed, described parameter list
- Path confinement: every file or folder parameter rejects paths outside your home folder and
INDESIGN_ALLOWED_DIRS
- MCP protocol: the server starts over stdio, sends instructions, lists all tools and answers
help for each
- Error detection: failure messages become
isError results
- Tool reference:
docs/TOOLS.md matches the definitions
- Script audit: see below
The script audit (tests/audit/scripts.audit.js) calls every tool with arguments built from its schema, captures the ExtendScript it would send, and fails if any advertised tool is not dispatched, if a script is not valid ES5 (ExtendScript has no let, arrow functions or JSON), or if a script uses a property, method, enum or global that does not exist in the InDesign 2023 scripting DOM (types-for-adobe).
CI runs check and npm test on every push and pull request. The audit checks scripts against Adobe's published DOM; it does not run them, so the integration suite against a live InDesign remains the final check.
Execution backends
| Backend | How to enable |
|---|
| ExtendScript / COM (default) | unset or INDESIGN_BACKEND=extendscript |
| UXP bridge + plugin | INDESIGN_BACKEND=uxp (or auto) + npx -p adobe-mcp-indesign adobe-mcp-indesign-uxp-bridge + load uxp/plugin |
| ArtCraft / DesignCraft | INDESIGN_TARGET=craft or automatic fallback when InDesign is absent and DesignCraft is running (127.0.0.1:7979) |
ArtCraft (DesignCraft) Support
This server features transparent adapter support for Storytold's DesignCraft desktop publishing application. When InDesign is not installed or running, or when INDESIGN_TARGET=craft (or ADOBE_TARGET=craft) is set, compatible tools route directly to DesignCraft's loopback control protocol (127.0.0.1:7979 by default or DESIGNCRAFT_CONTROL_PORT).
Details: docs/architecture-execution.md and uxp/README.md.
Optional packaging reference: theloniuser/indesign-uxp-server (bridge/plugin adapted into uxp/ with attribution).
Examples
See examples/basic-flyer.md and examples/mcp-config.json for a first-run workflow and client config.
Contributing
See CONTRIBUTING.md. Report security issues privately as described in SECURITY.md.
Credits
This server began as lucdesign/indesign-mcp-server by Lukas Drechsel-Burkhard, released under the MIT License. This project builds on that work; the original copyright notice is kept in LICENSE.
License
MIT. See LICENSE.
Documentation
Issues: https://github.com/zachshallbetter/adobe-mcp/issues