# EditableImage MCP — Editable Draw.io Diagrams

> EditableImage MCP — Editable Draw.io Diagrams is an open-source MCP server for design and media. Builds Draw.io flowcharts with attached connectors from structured node lists. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://editableimage.com
- **Repository:** https://github.com/j-river/editableimage-mcp
- **MCP Registry name:** io.github.j-river/editableimage
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-14

## About

This server starts from geometry, not a picture. It does no OCR and does not read screenshots; an agent supplies nodes and edges and gets back a native Draw.io file where arrows stay attached when boxes move.

Three tools chain together: one lays out ordered nodes in a fixed-spacing row or column, one validates geometry, supported styles, unique ids and connector references, and one exports a single-page .drawio document or bare model. Shapes are rectangle, rounded rectangle, ellipse, diamond and cylinder, with basic font, fill, stroke and opacity. Layout follows input order and is not an optimiser.

It runs locally on Node.js 22 or newer, makes no network requests and does not write files itself. EditableImage's separate web product handles converting images into diagrams.

## Features

- **Flowchart scene builder:** Places ordered nodes in a row or column.
- **Scene validation:** Checks geometry, styles, unique ids and edge references.
- **Native Draw.io export:** Returns real nodes and bound connectors, not a flat image.
- **Five node shapes:** Rectangle, rounded rectangle, ellipse, diamond, cylinder.
- **Offline and local:** No uploads, telemetry or paid calls.

## Good for

- Draft a process flow an agent can describe in words
- Generate editable diagrams for documentation
- Validate a generated diagram scene before export
- Produce a starting .drawio file to refine by hand

## Install

### Claude Code (Terminal)

```sh
claude mcp add editableimage -- npx -y editableimage-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "editableimage": {
      "command": "npx",
      "args": [
        "-y",
        "editableimage-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "editableimage": {
      "command": "npx",
      "args": [
        "-y",
        "editableimage-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "editableimage": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "editableimage-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "editableimage": {
      "command": "npx",
      "args": [
        "-y",
        "editableimage-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "editableimage": {
      "command": "npx",
      "args": [
        "-y",
        "editableimage-mcp"
      ]
    }
  }
}
```

## Tools

- `create_flowchart_scene`: Place ordered nodes in a row or column and return scene JSON
- `validate_diagram_scene`: Check geometry, styles, unique ids and connector references
- `export_drawio`: Return a single-page .drawio document or bare mxGraphModel

## FAQ

### Can it turn a screenshot into a diagram?

No. It builds from structured geometry; image recognition is in the separate EditableImage product.

### Does it save the file?

No. It returns XML; your client must save it to a new .drawio file.

### What Node version is needed?

Node.js 22 or newer.

### Is EditableImage MCP — Editable Draw.io Diagrams free?

Yes. EditableImage MCP — Editable Draw.io Diagrams is open source, so you can use and self-host it for free.

### How do I add EditableImage MCP — Editable Draw.io Diagrams to Claude Code?

Run this command in your terminal: claude mcp add editableimage -- npx -y editableimage-mcp

### What are the best alternatives to EditableImage MCP — Editable Draw.io Diagrams?

The closest alternatives to EditableImage MCP — Editable Draw.io Diagrams are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/editableimage-mcp-editable-draw-io-diagrams
