InDesign MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
InDesign MCP Server
Fork of lucdesign/indesign-mcp-server (MIT). This version adds:
Windows support via COM (
windows-runner.js); macOS/AppleScript still worksBook layout tools:
set_style,apply_style,create_parent_page,apply_parent_page,set_page_numbering,get_page_structure,import_from_document
export_ebook: EPUB 3 with one file per chapter, heading tags, navigation TOC, metadata/ISBN and coverIndic scripts (Odia, Hindi, Bengali, Tamilβ¦): automatic font fallback + World-Ready composer, and
apply_script_fontsA rewritten
insert_markdown_text, plus fixes for many upstream bugs (result capture, string escaping, ES3 polyfills, PDF/image/EPUB export, tables, preflight, packaging, page-relative positioning). All 60 tools were tested against InDesign 2027 (v22) on Windows.
A comprehensive Model Context Protocol (MCP) server for Adobe InDesign automation with 60 professional tools. This server enables AI assistants like Claude to directly control Adobe InDesign, automating complex publishing workflows, document creation, and professional layout tasks.
π Features
π Document Management
Create, open, save, and close documents with advanced options
Support for all standard formats (A4, A5, Letter, Legal, Custom)
Facing pages, bleeds, slugs, and margin configuration
Multi-page document handling
βοΈ Text & Typography
Advanced text frame creation and editing
Character and paragraph style management
Find/replace with GREP support
Professional typography controls (leading, tracking, optical margin alignment)
π¨ Graphics & Layout
Image placement with multiple fit options
Shape creation (rectangles, ellipses with styling)
Layer management and organization
Color swatch creation and management (CMYK, RGB, Spot colors)
π Tables & Data
Table creation and data population
Support for headers and footers
CSV data integration capabilities
π€ Export & Production
Professional PDF export with presets
Multi-format image export (PNG, JPEG, TIFF)
EPUB export for digital publishing
Package for print production
Preflight checking
π§ Automation & Scripting
Data merge operations
Custom ExtendScript execution
Batch processing capabilities
Professional publishing workflows
Related MCP server: indesign-mcp-server
π Prerequisites
Adobe InDesign 2025 (or compatible version)
macOS (required for AppleScript integration)
Node.js 18+
MCP-compatible client (like Claude Desktop)
Windows
Windows is supported through COM: windows-runner.js runs each tool's ExtendScript via
cscript β InDesign.Application. No extra dependencies. Each tool call is one undo step
("Claude MCP"). Environment variables:
Variable | Default | Purpose |
|
| Target a version, e.g. |
| your home folder | Extra file roots, |
|
| Per-call timeout (first call may launch InDesign) |
| off |
|
Indic scripts (Odia, Hindi, Bengali, Tamilβ¦)
Latin fonts such as Minion Pro have no Indic glyphs, so that text shows as empty boxes.
Every text-writing tool now moves just the Indic runs into an installed font that covers the
script (e.g. Noto Sans Oriya, Nirmala UI), keeping bold where the font has it, and switches
those paragraphs to the World-Ready composer. Runs already in an Indic font are left alone.
apply_script_fonts does the same for an existing document (optionally forcing a family).
Shared ExtendScript helpers live in prelude.jsx, which is prepended to every tool script.
Book layout tools (book-tools.js)
Tool | Does |
| Create/update a paragraph or character style with any InDesign properties (style groups, basedOn, nextStyle, enums like |
| Apply a paragraph/character style by text or GREP, by frame, or by paragraph; optionally clear hand formatting |
| Parent spread with auto page number (folio), running heads (static or |
| Apply a parent to pages ( |
| Numbering sections: start page, ARABIC / LOWER_ROMAN / β¦, start number, prefix |
| Parents and the pages using them, sections, style usage counts |
| Copy styles and parent pages from another .indd/.indt |
| EPUB 3 (reflowable/fixed): one file per chapter, styleβh1/h2/p tags, nav TOC, metadata + ISBN, cover, skip print-only pages |
Positioned tools now take x/y relative to the page. The server switches the ruler origin to the page while they run; before this, frames meant for a right-hand page landed on the left page of the spread.
Markdown
insert_markdown_text supports headings, paragraphs, bold, italic, both,
inline code, fenced code blocks, bullet/numbered lists (nested), block quotes, links (text
kept) and \ escapes. It uses existing styles (Heading 1, Bullet List, Bold, Codeβ¦) and
creates any that are missing. If the body font has no bold/italic face, faux bold/italic is used.
π οΈ Installation
1. Clone the Repository
git clone https://github.com/lucdesign/indesign-mcp-server.git
cd indesign-mcp-server2. Install Dependencies
npm install3. Configure MCP Client
Add the server to your MCP client configuration (e.g., Claude Desktop):
claude_desktop_config.json:
{
"mcpServers": {
"indesign": {
"command": "node",
"args": ["/path/to/indesign-mcp-server/index.js"],
"env": {}
}
}
}4. Start Adobe InDesign
Ensure Adobe InDesign is running before using the MCP server.
π― Quick Start
Create a Professional Document
// Create an A4 document with facing pages
create_document({
preset: "A4",
orientation: "Portrait",
pages: 4,
facingPages: true,
marginTop: 20,
marginBottom: 20,
marginLeft: 20,
marginRight: 20
})Add Formatted Text
// Create a text frame with professional typography
create_text_frame({
content: "Professional Publishing with InDesign MCP",
x: 20,
y: 20,
width: 170,
height: 50,
fontSize: 18,
fontFamily: "Helvetica Neue",
fontStyle: "Bold",
alignment: "LEFT_ALIGN"
})Create and Apply Styles
// Create a character style
create_character_style({
name: "Emphasis",
fontFamily: "Helvetica Neue",
fontStyle: "Italic",
textColor: "Red"
})
// Apply to specific text
find_replace_text({
findText: "important",
replaceText: "important",
applyCharacterStyle: "Emphasis"
})Export Professional PDF
export_pdf({
filePath: "/path/to/output.pdf",
preset: "HighQualityPrint",
includeBleed: true,
colorProfile: "ISO Coated v2"
})π οΈ Available Tools
Document Management (5 tools)
get_document_info- Document information and statisticscreate_document- Advanced document creationopen_document- Open existing documentssave_document- Save with optional new pathclose_document- Close with save options
Page Management (4 tools)
add_page- Add pages with position controldelete_page- Remove pages safelyduplicate_page- Copy pages with contentnavigate_to_page- Page navigation
Text Management (3 tools)
create_text_frame- Advanced text frame creationedit_text_frame- Modify existing framesfind_replace_text- Search and replace with GREP
Graphics Management (3 tools)
place_image- Image placement with fit optionscreate_rectangle- Rectangle creation with stylingcreate_ellipse- Ellipse creation with styling
Style Management (4 tools)
create_paragraph_style- Paragraph style creationcreate_character_style- Character style creationapply_paragraph_style- Apply styles to textlist_styles- List all available styles
Color Management (3 tools)
create_color_swatch- Create CMYK/RGB/Spot colorslist_color_swatches- List available colorsapply_color- Apply colors to objects
Table Management (2 tools)
create_table- Table creation with headers/footerspopulate_table- Fill tables with data
Layer Management (3 tools)
create_layer- Create new layersset_active_layer- Switch active layerlist_layers- List all layers
Export & Production (4 tools)
export_pdf- Professional PDF exportexport_images- Multi-format image exportexport_epub- Digital publishing exportpackage_document- Print production packaging
Automation & Utilities (4 tools)
execute_indesign_code- Custom ExtendScript executionpreflight_document- Quality checkingview_document- Document visualizationdata_merge- Automated data integration
π‘ Use Cases
Automated Publishing
Generate newsletters, brochures, and reports from data
Batch process multiple documents
Consistent styling across document series
Data-Driven Documents
Mail merge for personalized materials
Catalog generation from databases
Financial reports with dynamic content
Professional Workflows
Template-based document creation
Brand compliance automation
Print production preparation
Educational Materials
Automated textbook layout
Exercise sheet generation
Multi-language document variants
π§ Advanced Configuration
Custom ExtendScript Integration
execute_indesign_code({
code: `
// Custom InDesign scripting
var doc = app.activeDocument;
// Your custom automation logic here
`
})Batch Processing Example
// Process multiple files
const files = ["doc1.indd", "doc2.indd", "doc3.indd"];
for (const file of files) {
await open_document({ filePath: file });
await export_pdf({
filePath: file.replace('.indd', '.pdf'),
preset: 'HighQualityPrint'
});
await close_document({ save: false });
}π Troubleshooting
Common Issues
"Adobe InDesign not found"
Ensure InDesign 2025 is installed and running
Check AppleScript permissions in System Preferences
"Script execution failed"
Verify Adobe InDesign is the active application
Check for document-specific errors in console
"Tool not found"
Restart MCP client after configuration changes
Verify server is running with
node index.js
Debug Mode
node --inspect index.jsπ€ Contributing
Fork the repository
Create a feature branch (
git checkout -b feature/AmazingFeature)Commit your changes (
git commit -m 'Add some AmazingFeature')Push to the branch (
git push origin feature/AmazingFeature)Open a Pull Request
π License
This project is licensed under the MIT License - see the LICENSE file for details.
π Acknowledgments
Anthropic for the Model Context Protocol
Adobe for InDesign ExtendScript API
MCP Community for tools and inspiration
π Support
Issues: GitHub Issues
Discussions: GitHub Discussions
Made with β€οΈ for the publishing community
Transform your InDesign workflows with AI automation
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Give your AI agents a design superpower. Generate, edit, and publish publication-grade decks, reports, landing pages, resumes, and marketing visuals directly within your agent workflow. Delivering frontier-level design quality at 3Γ the speed and 53Γ lower cost -from conversational prompt to live link or vector PDF in minutes.
Convert, create and edit Word, PowerPoint, Excel and PDF documents from any AI agent.
Build and run AI image, video and on-brand ad workflows from chat, with brand kits and share links.
Build and run visual creative-production workflows from your AI agent.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to inspect, modify, export, and validate design documents with 47 tools covering design, code generation, branding, and print/mockup workflows.5 npm2MIT
- AlicenseCqualityCmaintenanceEnables AI assistants to automate Adobe InDesign publishing workflows, including document creation, text formatting, image placement, PDF export, and more via 35+ professional tools.3660 npm61MIT
- AlicenseCqualityBmaintenanceTransforms Adobe InDesign into an AI-powered design automation platform with 135+ professional tools for seamless programmatic control over layout and design capabilities.210025 npm32MIT
- AlicenseCqualityDmaintenanceEnables AI assistants to control Adobe InDesign for automated publishing workflows, document creation, and layout tasks across macOS and Windows.363MIT