Next AI Draw.io MCP Server: Setup for Claude Code, Cursor and Other Apps

• Opens the diagram preview in your browser

  Starts a session, opens the live draw.io preview and returns the drawing guide. Give it a saved session to continue an earlier diagram.

  Try: “Start a new diagram session.”

  Files · start_session

• Draws a new diagram

  Replaces the canvas with a diagram the assistant describes in draw.io XML. It appears in the preview as it is drawn.

  Try: “Read this repo and draw its architecture.”

  Write · create_new_diagram

• Changes shapes in the current diagram

  Adds, updates or deletes shapes by id. All the edits apply together or none do.

  Try: “Add a cache box between the API and the database.”

  Delete · edit_diagram

• Reads the diagram as it is now

  Returns the current diagram, including any changes you made by hand in the browser.

  Try: “Read the diagram back, including my edits.”

  Read · get_diagram

• Reads which shapes you selected

  Returns the shapes you have selected in the preview, so you can say "these" or "this one".

  Try: “Make the shapes I selected blue.”

  Read · get_selection

• Takes a picture of the diagram

  Returns a PNG of a page so the assistant can check for overlaps and fix them.

  Try: “Look at the diagram and fix anything that overlaps.”

  Read · screenshot_diagram

• Opens a .drawio file from disk

  Loads a .drawio or .drawio.svg file into the canvas.

  Try: “Open docs/architecture.drawio.”

  Files · load_diagram

• Saves the diagram as a file

  Writes the diagram as .drawio, .png, .svg or .drawio.svg to a path you give. Images get a 20 px margin, and PNGs a white background unless you ask for a transparent one.

  Try: “Export the diagram to docs/architecture.png.”

  Write · export_diagram

• Goes back to an earlier version

  Restores one of the last 20 versions of the diagram. A redo stays possible.

  Try: “Undo the last two changes.”

  Write · restore_version

• Lists diagrams from earlier sessions

  Lists saved diagrams, newest first, so you can continue one in a new chat.

  Try: “Which diagrams have I saved?”

  Files · list_saved_diagrams

• Lists the pages in the diagram

  Lists the pages (tabs) of a multi-page diagram.

  Try: “What pages does this diagram have?”

  Read · list_pages

• Adds a page to the diagram

  Adds a new page (tab) to the diagram.

  Try: “Add a page called "Deployment".”

  Write · add_page

• Renames a page

  Gives a page of the diagram a new name.

  Try: “Rename page 2 to "Data flow".”

  Write · rename_page

• Deletes a page from the diagram

  Removes a page and its shapes from the diagram. You can go back with an earlier version.

  Try: “Delete the "Draft" page.”

  Delete · delete_page

• Used by the assistant behind the scenes

  Repeats the drawing rules

  Returns the rules the assistant follows for shapes, layout and styling, including your own rules from instructions.md.

  Try: “Show me the drawing rules you follow.”

  Read · get_drawing_guide

• Shows icon styles for a shape set

  Returns the shape names for a library such as AWS, Azure, GCP or Kubernetes, so the assistant uses real icons.

  Try: “Which AWS icons can you use?”

  Read · get_shape_library

Watch out for

• Export and load use file paths on your machine

  export_diagram writes to any path it is given and creates missing folders; load_diagram reads a path. Review the path in the approval prompt. github.com

• Diagrams are saved in your home folder

  Every change is saved under ~/.next-ai-drawio, and the newest 50 diagrams are kept. Set DRAWIO_DATA_DIR to off if you do not want that. github.com

• A local web server runs while it is open

  It serves the preview on 127.0.0.1, and every API request needs a token only the preview page has. Do not forward the port. github.com

Security advisories