MCP serverInstalls cleanly

Draw diagrams on a live draw.io canvas

Next AI Draw.io

A connector that lets your assistant draw flowcharts and other diagrams on a live draw.io page in your browser, which you can also edit by hand.

Works with
Claude Code, Codex CLI
Good for
Daily work and research, Graphic designers

What it does

Next AI Draw.io connects your assistant to draw.io, a free diagram editor. You describe a diagram in plain words, for example a process, an org chart or a customer journey. The assistant draws it on a real draw.io page that opens in your browser.

The page is shared. You can drag boxes, rename them or change colours yourself, and the assistant reads your changes before it edits again. You can also select a few shapes and say "change these". The last 20 versions are kept, so you can compare, go back, or press Ctrl+Z to undo the assistant's last change.

When you are happy, you can save the diagram as a .drawio file to edit later, or as a PNG or SVG picture for a document or a slide. The draw.io editor comes inside the package, so the preview also works without an internet connection.

The server runs on your computer and talks only to your own browser. The preview page is on localhost and needs a key that only that page has, so other websites cannot read your diagram (README). We found no usage tracking in the server code.

Each diagram is saved in the ~/.next-ai-drawio/ folder, so you can continue it in a later conversation. If you write your own drawing rules in ~/.next-ai-drawio/instructions.md, for example "Always use a minimal style", the assistant gets them on every call.

Who it is for

People who need simple diagrams for documents, slides or planning and want to describe them in words, then fix the details by hand.

Example prompts

  • "Draw a flowchart of how a customer order moves from checkout to delivery."
  • "Make an org chart for a team of eight with two managers."
  • "Read this folder and draw a diagram of how the parts fit together."
  • "Turn these meeting notes into a simple process diagram."
  • "Export the diagram as a PNG file."

How to install

claude mcp add --scope user drawio -- npx @next-ai-drawio/mcp-server@latest

How to use it

Ask: Draw a flowchart of how a customer order moves from checkout to delivery. A preview opens in your browser and the diagram appears as it is drawn.

Other assistants

It is also a Claude Code plugin in Anthropic's community plugin directory. The README line needs Claude Code 2.1.275 or later. We have not tested this route. Use one route only:

text
/plugin install next-ai-drawio --marketplace anthropics/claude-plugins-community

Codex CLI (from the setup page):

codex mcp add drawio -- npx @next-ai-drawio/mcp-server@latest

Check it works

  1. In Claude Code, run claude mcp list. The docs say each server shows a status such as ✔ Connected. Look for drawio.
  2. Ask for a small flowchart. The preview should open in your browser, and the diagram should appear as it is drawn.

Common problems

  • The tools only work in one folder — the server was added without --scope user — add it again with --scope user, so it works in every project (setup page).
  • Codex stops with "MCP tool call requires approval" — codex exec without full access cannot ask you — run Codex normally and approve, or use the default_tools_approval_mode setting the docs show (fewer checks).
  • The tools do not show up after install — the client has not reloaded — restart Claude Code or Codex, as the setup page says.
  • You do not want a browser window to open — set BROWSER=none before you start the assistant (server code).

What to watch out for

  • Runs shell commands: npx downloads and starts the newest @latest version of the server every time your assistant starts it, so the code can change without you noticing
  • Needs Node.js 18 or later for npx (package.json)
  • Opens a local preview page in your browser and saves every diagram to the ~/.next-ai-drawio/ folder on your computer; the newest 50 are kept (README). DRAWIO_DATA_DIR=off turns saving off
  • In Codex each tool that changes the diagram asks first; the docs show a setting that turns those questions off, which also means fewer checks
  • The README and setup page also offer a prompt that tells your assistant to fetch and follow a README from the internet; use the install command above instead

Licence and author

Licence
Apache-2.0
Author
DayuanJiang
Source code
github.com/DayuanJiang/next-ai-draw-io

How we tested it

We installed it on an empty test computer on 21 Oct 2026. Installed and started in a clean test system. Not yet used in a real AI session.

Test level

Not run: "codex mcp add drawio -- npx @next-ai-drawio/mcp-server@latest" (not a form the sandbox runs) and the community-marketplace plugin. No diagram was drawn, so the browser preview did not open. Not yet used on real work.

Technical details of the test
Date
21 Oct 2026
Method
Intake sandbox run on 2026-10-21 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files; added drawio with "claude mcp add" and checked the connection.

Checked again on 21 Oct 2026

Alternatives

  • Archify — draws diagrams that explain a system from your text or code, without a shared live canvas.
  • draw.io's own MCP server, @drawio/mcp — opens each diagram in the full draw.io editor, but no tool reads it back (comparison table in the README).
  • playground — clickable pages to pick options, not diagrams.

FAQ

Do I need a draw.io account? No. The editor comes inside the package and runs on your computer.

Do I need an extra AI key? Not for the connector; your assistant does the drawing. The separate Next AI Draw.io web app is different: there you enter your own AI provider key in the browser (README).

Can I open the result in normal draw.io? Yes. Save it as a .drawio file.

Does it work in Gemini CLI? The setup page lists Claude Code, Codex, VS Code, Cursor and others. Gemini CLI is not listed.

Sources