Skip to main content
Glama
indesign-mcp-server

indesign-mcp-server

by lucdesign

InDesign MCP Server

A comprehensive Model Context Protocol (MCP) server for Adobe InDesign automation with 51+ 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)

🛠️ 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

Available Tools

36 tools
add_pageB

Add a new page to the document

Inputs: position, pageIndex, masterPage.

apply_colorC

Apply color to an object

Inputs: swatchName (required), objectIndex (required), property, pageIndex.

apply_paragraph_styleB

Apply a paragraph style to text

Inputs: styleName (required), frameIndex (required), endIndex, pageIndex, +1 more.

close_documentB

Close the current document

Inputs: save.

create_character_styleC

Create a new character style

Inputs: name (required), fontSize, tracking, baseStyle, +3 more.

create_color_swatchB

Create a new color swatch

Inputs: name (required), colorValues (required), spotColor, colorModel.

create_documentB

Create a new InDesign document with advanced options

Inputs: slug, bleed, pages, width, +8 more.

create_ellipseC

Create an ellipse shape

Inputs: x (required), y (required), width (required), height (required), +4 more.

create_layerC

Create a new layer

Inputs: name (required), color, locked, visible.

create_paragraph_styleC

Create a new paragraph style

Inputs: name (required), leading, fontSize, alignment, +5 more.

create_rectangleC

Create a rectangle shape

Inputs: x (required), y (required), width (required), height (required), +5 more.

create_tableC

Create a table

Inputs: x (required), y (required), rows (required), width (required), +5 more.

create_text_frameB

Create a text frame with advanced formatting options

Inputs: content (required), x, y, width, +9 more.

data_mergeD

Perform data merge operation

Inputs: outputFolder (required), dataSourcePath (required), fileFormat, recordRange.

delete_pageB

Delete a page from the document

Inputs: pageIndex (required).

duplicate_pageC

Duplicate a page

Inputs: pageIndex (required), position.

edit_text_frameB

Edit properties of an existing text frame

Inputs: frameIndex (required), content, fontSize, alignment, +3 more.

execute_indesign_codeC

Execute custom ExtendScript code in InDesign

Inputs: code (required).

export_epubC

Export document as EPUB

Inputs: filePath (required), version, imageFormat, includeImages.

export_imagesB

Export pages as images

Inputs: folderPath (required), format, pageRange, resolution, +1 more.

export_pdfC

Export document as PDF with advanced options

Inputs: filePath (required), preset, pageRange, includeSlug, +3 more.

find_replace_textC

Find and replace text in the document

Inputs: findText (required), replaceText (required), scope, useGrep, +2 more.

get_document_infoB

Get detailed information about the current InDesign document

Inputs: no named parameters.

list_color_swatchesA

List all color swatches in the document

Inputs: no named parameters.

list_layersA

List all layers in the document

Inputs: no named parameters.

list_stylesC

List all available styles in the document

Inputs: styleType.

open_documentB

Open an existing InDesign document

Inputs: filePath (required).

package_documentB

Package document for print production

Inputs: folderPath (required), createReport, includeFonts, includeLinkedFiles.

place_imageC

Place an image with advanced options

Inputs: imagePath (required), x, y, width, +4 more.

populate_tableC

Populate table with data

Inputs: data (required), tableIndex (required), pageIndex, includeHeaders.

preflight_documentC

Run preflight check on the document

Inputs: scope, profile.

save_documentB

Save the current document

Inputs: filePath.

set_active_layerC

Set the active layer

Inputs: layerName (required).

view_documentB

Get visual representation and detailed info about the current document

Inputs: no named parameters.

zoom_to_pageC

Zoom and fit page in view

Inputs: fitOption, pageIndex.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.7/5.0

    Scored across 36 tools

    Disambiguation4/5

    Most tools target distinct resource-action pairs, but get_document_info and view_document both provide document overview, and navigate_to_page/zoom_to_page are visually oriented. Descriptions likely clarify, but a few pairs could cause misselection.

    Naming Consistency5/5

    All tools use verb_noun snake_case consistently (create_document, export_pdf, list_layers), with clear verbs and resource names. No mixed conventions or vague verbs.

    Tool Count2/5

    At 36 tools, this exceeds the 25+ threshold for 'too many'. While InDesign is complex, many tools could be consolidated (e.g., export_* variants, create_rectangle/ellipse), making the surface heavier than necessary.

    Completeness3/5

    The server covers document lifecycle, page management, styles, layers, and exports, but lacks object deletion, movement, or listing beyond pages. The execute_indesign_code tool mitigates gaps, but agents will need to use it for missing operations.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      C
      maintenance
      Enables AI assistants to control and automate Adobe InDesign on Windows through COM and ExtendScript, offering 51 tools for document creation, editing, styling, and PDF export.
      51
      1
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Enables AI agents to drive Adobe InDesign on the user's own machine, creating documents, pages, text frames, shapes, tables, styles, masters and more, plus exporting to PDF/EPUB/HTML/images. It exposes 197 tools across 34 handlers, bridging via a UXP plugin, macOS JXA, or Windows COM so nothing leaves the local box.
      197
      284 npm
      50
      MIT