Skip to main content
Glama
InDesign MCP Server

InDesign MCP Server

by vinitdeep

InDesign MCP Server

Fork of lucdesign/indesign-mcp-server (MIT). This version adds:

  • Windows support via COM (windows-runner.js); macOS/AppleScript still works

  • Book 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 cover

  • Indic scripts (Odia, Hindi, Bengali, Tamil…): automatic font fallback + World-Ready composer, and apply_script_fonts

  • A 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

INDESIGN_PROGID

InDesign.Application (newest installed)

Target a version, e.g. InDesign.Application.2026

INDESIGN_ALLOWED_DIRS

your home folder

Extra file roots, ;-separated (e.g. E:\;D:\Work)

INDESIGN_TIMEOUT_MS

180000

Per-call timeout (first call may launch InDesign)

INDESIGN_ALLOW_ARBITRARY_CODE

off

1 enables execute_indesign_code

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

set_style

Create/update a paragraph or character style with any InDesign properties (style groups, basedOn, nextStyle, enums like NEXT_ODD_PAGE)

apply_style

Apply a paragraph/character style by text or GREP, by frame, or by paragraph; optionally clear hand formatting

create_parent_page

Parent spread with auto page number (folio), running heads (static or {{style:Chapter Title}} live variable), threaded primary text frame

apply_parent_page

Apply a parent to pages ("1-8, 12, 20-end", all, odd, even)

set_page_numbering

Numbering sections: start page, ARABIC / LOWER_ROMAN / …, start number, prefix

get_page_structure

Parents and the pages using them, sections, style usage counts

import_from_document

Copy styles and parent pages from another .indd/.indt

export_ebook

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-server

2. Install Dependencies

npm install

3. 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 statistics

  • create_document - Advanced document creation

  • open_document - Open existing documents

  • save_document - Save with optional new path

  • close_document - Close with save options

Page Management (4 tools)

  • add_page - Add pages with position control

  • delete_page - Remove pages safely

  • duplicate_page - Copy pages with content

  • navigate_to_page - Page navigation

Text Management (3 tools)

  • create_text_frame - Advanced text frame creation

  • edit_text_frame - Modify existing frames

  • find_replace_text - Search and replace with GREP

Graphics Management (3 tools)

  • place_image - Image placement with fit options

  • create_rectangle - Rectangle creation with styling

  • create_ellipse - Ellipse creation with styling

Style Management (4 tools)

  • create_paragraph_style - Paragraph style creation

  • create_character_style - Character style creation

  • apply_paragraph_style - Apply styles to text

  • list_styles - List all available styles

Color Management (3 tools)

  • create_color_swatch - Create CMYK/RGB/Spot colors

  • list_color_swatches - List available colors

  • apply_color - Apply colors to objects

Table Management (2 tools)

  • create_table - Table creation with headers/footers

  • populate_table - Fill tables with data

Layer Management (3 tools)

  • create_layer - Create new layers

  • set_active_layer - Switch active layer

  • list_layers - List all layers

Export & Production (4 tools)

  • export_pdf - Professional PDF export

  • export_images - Multi-format image export

  • export_epub - Digital publishing export

  • package_document - Print production packaging

Automation & Utilities (4 tools)

  • execute_indesign_code - Custom ExtendScript execution

  • preflight_document - Quality checking

  • view_document - Document visualization

  • data_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

  1. Fork the repository

  2. Create a feature branch (git checkout -b feature/AmazingFeature)

  3. Commit your changes (git commit -m 'Add some AmazingFeature')

  4. Push to the branch (git push origin feature/AmazingFeature)

  5. 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


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…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to inspect, modify, export, and validate design documents with 47 tools covering design, code generation, branding, and print/mockup workflows.
      5 npm
      2
      MIT
    • A
      license
      C
      quality
      C
      maintenance
      Enables AI assistants to automate Adobe InDesign publishing workflows, including document creation, text formatting, image placement, PDF export, and more via 35+ professional tools.
      36
      60 npm
      61
      MIT