Draw.io MCP Server by lgazo: Setup for Claude, Cursor and Other Apps

• Adds a rectangle to a page

  Adds a new rectangle shape on a page of the open Draw.io document, with position, size, text and style.

  Try: “Add a rectangle labelled API Gateway at the top of the page.”

  Write · add-rectangle

• Adds a shape from the Draw.io library by name

  Adds a new shape to a page by its library name, such as an AWS or Cisco icon, so the assistant can place proper icons.

  Try: “Add the Cisco router icon and label it Edge.”

  Write · add-cell-of-shape

• Connects two shapes with a line

  Creates an edge between two shapes. If both ends are the same shape, a loop style is applied automatically.

  Try: “Connect the API Gateway to the Orders service with an arrow.”

  Write · add-edge

• Changes an existing shape

  Updates only the properties you give for a shape, such as its text, size, position or style, and leaves the rest as it was.

  Try: “Make the Database shape wider and change its text to Postgres.”

  Write · edit-cell

• Changes an existing line

  Updates the properties of a connecting line and can set waypoints to control its route.

  Try: “Route the line from Queue to Worker around the Cache box.”

  Write · edit-edge

• Restyles a shape to match a library shape

  Changes the look of an existing shape so it matches a named shape from the library.

  Try: “Change the Server box to the AWS Lambda icon.”

  Write · set-cell-shape

• Stores a custom attribute on a shape

  Sets or updates a custom data attribute on an existing shape.

  Try: “Tag the Billing service with owner=payments.”

  Write · set-cell-data

• Groups a shape inside another

  Makes one shape a child of another, so moving the parent moves its children.

  Try: “Put the three services inside the Backend container.”

  Write · set-cell-parent

• Deletes a shape or line

  Deletes a shape or line from the target page by its ID.

  Try: “Delete the unused Legacy box from the diagram.”

  Delete · delete-cell-by-id

• Lists the shapes and lines on a page

  Returns the shapes and lines on a page in pages of results, with essential fields only.

  Try: “List everything on page 1 of this diagram.”

  Read · list-paged-model

• Shows the shape you have selected

  Returns details of the shape currently selected in the editor. The editor may switch to the target page first.

  Try: “What do I have selected right now?”

  Read · get-selected-cell

• Lists shape library categories

  Returns the shape categories available in the Draw.io library.

  Try: “Which shape categories can you use?”

  Read · get-shape-categories

• Lists the shapes in one category

  Returns all shapes in a library category, with the style used to create each.

  Try: “Show me the shapes in the AWS compute category.”

  Read · get-shapes-in-category

• Looks up one library shape

  Finds a shape by name in the library and returns it with its category.

  Try: “Find the shape called cloud_run.”

  Read · get-shape-by-name

• Lists open Draw.io documents

  Lists the connected Draw.io documents with stable IDs, so later calls can target one tab or file.

  Try: “Which diagrams do you have open?”

  Read · list-documents

• Renames the open document

  Renames the current document through its storage provider and keeps the file extension.

  Try: “Rename this diagram to Payments architecture.”

  Write · set-document-title

• Saves the open document

  Runs Draw.io's own File > Save action. Your storage provider may show a sign-in, conflict or Save As prompt that needs you.

  Try: “Save the diagram.”

  Write · save-document

• Lists the pages in a document

  Lists every page with its index, ID, name and whether it is current.

  Try: “What pages does this diagram have?”

  Read · list-pages

• Shows the page you are on

  Returns the visible page's index, ID and name.

  Try: “Which page am I looking at?”

  Read · get-current-page

• Adds a blank page

  Appends a new blank page to the document without switching your view when the runtime allows.

  Try: “Add a new page for the retry flow.”

  Write · create-page

• Duplicates a page

  Copies an existing page to the end of the document and returns the new page's details.

  Try: “Copy page 1 so I can try a variation.”

  Write · copy-page

• Renames a page

  Renames a page without changing which page is visible.

  Try: “Rename page 2 to Message flow.”

  Write · rename-page

• Lists layers on a page

  Lists the layers on a page with their IDs and names.

  Try: “What layers are on this page?”

  Read · list-layers

• Shows the active layer

  Returns the layer new elements are added to. The editor may switch pages first because this state is tied to the screen.

  Try: “Which layer am I drawing on?”

  Read · get-active-layer

• Chooses the layer to draw on

  Sets the layer where all new elements will be created.

  Try: “Switch to the Annotations layer.”

  Write · set-active-layer

• Creates a layer

  Creates a new layer on a page.

  Try: “Create a layer called Background.”

  Write · create-layer

• Moves a shape to another layer

  Moves a shape from its current layer to a target layer.

  Try: “Move all decorative shapes to the Background layer.”

  Write · move-cell-to-layer

• Exports the diagram as SVG, PNG or XML

  Exports a page or the whole diagram and returns the data, or saves it to a file path if you give one.

  Try: “Export the current page as SVG.”

  Write · export-diagram

• Loads a diagram from XML, SVG or PNG

  Imports a diagram from XML, SVG or PNG with embedded XML. It can replace a page, add to it, or open a new page, so replace mode overwrites what is there.

  Try: “Import this XML onto a new page.”

  Write · import-diagram

• Turns Mermaid text into a diagram

  Inserts a Mermaid diagram into a page, either converted to editable shapes or embedded as one image that keeps the source.

  Try: “Convert this Mermaid flowchart into a Draw.io diagram.”

  Write · import-mermaid

Watch out for

• The local editor port has no sign-in and no bind address by default

  The docs say the bind address is chosen by the OS, but the code passes none unless you set the host flag, and Node then listens on every network interface for the editor and the extension connection. The HTTP routes also allow any origin. Add the host flag set to 127.0.0.1 on shared networks, and do not combine it with the HTTP transport option on an untrusted network. github.com

• It can delete shapes and overwrite pages

  delete-cell-by-id removes shapes, and import-diagram in replace mode overwrites a page. There is no read-only mode, so keep backups of diagrams you care about. github.com

• It downloads editor files on first run

  The package fetches the latest Draw.io web build from the jgraph/drawio GitHub releases and caches it, so the first start needs internet access. npmjs.com

• export-diagram can write to a path

  When you give a file path, the export is saved there. Check the path the assistant picks. github.com

Security advisories