# idmly: HTML to InDesign (IDML)

> idmly: HTML to InDesign (IDML) is a freemium MCP server for design and media. Convert a self-contained HTML design into an editable Adobe InDesign IDML file. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, CLI
- **Website:** https://www.idmly.com
- **Repository:** https://github.com/kellykazi3/idmly-mcp
- **MCP Registry name:** io.github.KellyKazi3/idmly-mcp
- **Categories:** design and media, files and documents
- **Listing updated:** 2026-11-14

## About

idmly takes the single HTML file an AI tool produced, such as a report, presentation or editorial layout, and returns a native `.idml` with editable text, named styles and vector charts. The site says conversion usually takes under 30 seconds.

The HTML must be self-contained: CSS and JavaScript inline and images embedded as data URIs. Screenshots, PDFs and share links cannot be uploaded. A failed conversion does not use up the free one, and fonts the file lists must be activated in InDesign.

The npm MCP server lets coding agents run the same conversion. Without a license key the first two pages convert free; a $49 one-time license covers unlimited full conversions on both the website and MCP.

## Features

- **HTML to native IDML:** Produces an editable InDesign file rather than flattened images.
- **Named styles:** Text keeps real, named paragraph styles.
- **Vector charts:** Charts are redrawn as real vectors.
- **Two pages free:** One preview of up to two pages without an account.
- **Agent-ready:** Works with Claude Code, Cursor, Codex, Windsurf and Claude Desktop.

## Good for

- Move an AI-generated report into InDesign
- Turn a presentation draft into an editable layout
- Hand a designer an editable file instead of HTML
- Convert an editorial page built in Claude or ChatGPT

## Install

### Claude Code (Terminal)

```sh
claude mcp add idmly-mcp --env IDMLY_LICENSE_KEY='<IDMLY_LICENSE_KEY>' -- npx -y idmly-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "idmly-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "idmly-mcp"
      ],
      "env": {
        "IDMLY_LICENSE_KEY": "<IDMLY_LICENSE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "idmly-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "idmly-mcp"
      ],
      "env": {
        "IDMLY_LICENSE_KEY": "<IDMLY_LICENSE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "idmly-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "idmly-mcp"
      ],
      "env": {
        "IDMLY_LICENSE_KEY": "<IDMLY_LICENSE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "idmly-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "idmly-mcp"
      ],
      "env": {
        "IDMLY_LICENSE_KEY": "<IDMLY_LICENSE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "idmly-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "idmly-mcp"
      ],
      "env": {
        "IDMLY_LICENSE_KEY": "<IDMLY_LICENSE_KEY>"
      }
    }
  }
}
```

## FAQ

### What does it cost?

Two pages convert free; a $49 one-time license unlocks unlimited full conversions.

### What input is accepted?

One self-contained .html file with inline CSS and JS and embedded images.

### Is a license key required?

Only for full conversions; set IDMLY_LICENSE_KEY to use it.

### Does a failed run use my free conversion?

No, the site says a failed conversion does not use one up.

### Is idmly: HTML to InDesign (IDML) free?

idmly: HTML to InDesign (IDML) has a free plan, with paid plans for more usage or features.

### How do I add idmly: HTML to InDesign (IDML) to Claude Code?

Run this command in your terminal: claude mcp add idmly-mcp --env IDMLY_LICENSE_KEY='<IDMLY_LICENSE_KEY>' -- npx -y idmly-mcp

### What are the best alternatives to idmly: HTML to InDesign (IDML)?

The closest alternatives to idmly: HTML to InDesign (IDML) are HyperFrames by HeyGen, ffmpeg-skill, ASTra, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/idmly-html-to-indesign-idml
