drawio-mcp: Instructions file for Claude Code

Draw.io MCP Server

The official draw.io MCP (Model Context Protocol) server that enables LLMs to open and create diagrams in the draw.io editor.

Repository Structure

• .claude-plugin/marketplace.json — Claude Code plugin marketplace manifest. Lists this repo's plugins (currently just drawio, sourced from ./plugins/claude-code); plugin metadata is inherited from each plugin's own plugin.json. Users install with /plugin marketplace add jgraph/drawio-mcp then /plugin install drawio@drawio.
• .agents/plugins/marketplace.json — Codex CLI plugin marketplace manifest (Codex's format: source object + policy + category). Lists the drawio plugin sourced from ./plugins/codex/drawio; metadata is inherited from that plugin's own .codex-plugin/plugin.json. Users install with codex plugin marketplace add jgraph/drawio-mcp then codex plugin add drawio@drawio.
• .github/plugin/marketplace.json — GitHub Copilot CLI plugin marketplace manifest (same schema family as Claude's, but plugin metadata is inlined in the plugins[] entry rather than inherited — keep it in sync with plugins/copilot/plugin.json). Lists the drawio plugin sourced from ./plugins/copilot. Users install with copilot plugin marketplace add jgraph/drawio-mcp then copilot plugin install drawio@drawio. Copilot CLI checks this path first and falls back to .claude-plugin/marketplace.json.
• .cursor-plugin/marketplace.json — Cursor plugin marketplace manifest (Cursor's format: owner + plugins[] entries whose source is the plugin directory). Lists the drawio plugin sourced from plugins/cursor; metadata comes from that plugin's own .cursor-plugin/plugin.json. Users install from the Cursor Marketplace (every version is reviewed by Cursor, submitted at cursor.com/marketplace/publish); Teams/Enterprise admins can import this repo as a team marketplace.
• glama.json — Ownership file for the Glama MCP directory: lists the GitHub users (maintainers) who may claim the listing of this org-hosted repo, which a GitHub sign-in alone can't. After editing it, run Glama's Claim flow again. We make no Glama releases: in October 2026 the listing had views but no use and sent no traffic.
• shared/ — Single source of truth shared by every delivery mechanism: the LLM-facing references (xml-reference.md, its condensed xml-essentials.md, mermaid-reference.md, style-reference.md) and the shared logic both MCP servers run (shape-search.js, icon-search.js, mermaid-elk.js, the repairs for common LLM slips in XML repair-xml.js, plus the headless mxGraph stack mx-model.js / mx-xml.js / normalize-model.js, and label-perimeter.js, which marks labels outside the shape so edges end at them).
• mcp-app-server/ — MCP App server (renders diagrams inline in chat via iframe). Hosted at https://mcp.draw.io/mcp. Can also be self-hosted via Node.js, the jgraph/drawio-mcp Docker Hub image (built and pushed by .github/workflows/publish-app-server-image.yml; Hub page text in mcp-app-server/DOCKER_HUB.md) or Cloudflare Workers. Its server.json is the MCP Community Registry manifest (io.draw/mcp — feeds github.com/mcp and VS Code's MCP browser); publish runbook in its README.
• mcp-tool-server/ — Original MCP tool server (stdio-based, opens browser). Published as @drawio/mcp on npm.
• project-instructions/ — Claude Project instructions (no MCP required, no install).
• plugins/ — Assistant-side plugins grouped by host, one subdirectory per AI assistant.
  • plugins/claude-code/ — Claude Code plugin: ships the drawio skill (generates native .drawio files, authored as Mermaid — converted + laid out by the desktop CLI — or as XML directly with optional ELK --layout; exports to PNG/SVG/PDF, or opens as a browser URL via app.diagrams.net). For shape-library and brand icons the skill runs its bundled scripts/find-shapes.js, which searches the search_shapes index (from jsDelivr) and the draw.io icon service. Mermaid conversion, ELK layout, and image export need draw.io Desktop; plain XML .drawio/url output does not. Installable via the repo-root marketplace or claude --plugin-dir ./plugins/claude-code. Since 1.2.3 it also bundles the hosted MCP App Server (.mcp.json, https://mcp.draw.io/mcp), so its Claude directory listing can be paired with the draw.io connector listing and the skill can defer to create_diagram where Claude shows diagrams inline (Claude.ai); in Claude Code's terminal the skill still writes the files. The Codex and Copilot ports stay skill-only.
  • plugins/codex/drawio/ — Codex CLI plugin: the Codex port of the Claude Code plugin, shipping the same drawio skill. skills/drawio/ (SKILL.md and scripts/) is byte-identical to the Claude plugin's copy (Codex uses the same /drawio:drawio invocation and fetches the same shared references from GitHub). Differs only in host wrapping: a .codex-plugin/plugin.json manifest with an interface block (official draw.io SVG logo, brandColor, default prompts). Nested under codex/ because Codex requires the plugin root folder name to equal plugin.json "name" (drawio). No MCP required.
  • plugins/copilot/ — GitHub Copilot CLI plugin: the Copilot port of the Claude Code plugin, shipping the same drawio skill. skills/drawio/ (SKILL.md and scripts/) is byte-identical to the Claude plugin's copy (the in-skill /drawio:drawio example lines are model-facing; Copilot's user-facing command is plain /drawio since Copilot doesn't prefix plugin skills). Differs only in host wrapping: a root plugin.json manifest (Copilot's format, skills directory list); no folder-name rule, so copilot/ is itself the plugin root. The same skill folder also works in other Copilot surfaces (VS Code agent mode, coding agent, code review) when copied to a repo's .github/skills/. No MCP required.
  • plugins/cursor/ — Cursor plugin: the same drawio skill (skills/drawio/, SKILL.md and scripts/, byte-identical to the Claude plugin's copy) plus an mcp.json that adds the hosted MCP App Server (https://mcp.draw.io/mcp), because Cursor's Agent chat (≥ 2.6) renders MCP Apps inline; the skill's own instructions already defer to create_diagram in such a chat and keep files and exports for the skill. Manifest .cursor-plugin/plugin.json (only name is required; logo is a repo-relative path, here the draw.io SVG in assets/). No folder-name rule, so cursor/ is itself the plugin root.
  • plugins/antigravity/ — Antigravity plugin: the same drawio skill (skills/drawio/, SKILL.md and scripts/, byte-identical to the Claude plugin's copy) with a minimal root plugin.json (Antigravity's schema allows only name, description, $schema; components are found by folder). Skill-only: Antigravity's converter turns a Claude plugin's HTTP MCP server into an empty command, and a terminal can only get links from the hosted server, so the README shows agy mcp add separately. No marketplace for other publishers: users install from the directory URL (agy plugin install https://github.com/jgraph/drawio-mcp/tree/main/plugins/antigravity); the repository URL installs every plugin in the repo under the same name. Porting notes in its DEVELOPING.md.
• shape-search/ — Shape search index generator. Loads draw.io's app.min.js via jsdom to extract all shape styles and tags into search-index.json, which powers the search_shapes MCP tool and the skill's scripts/find-shapes.js (it reads title, tags, w, h and style from the @main copy on jsDelivr, so renaming a field breaks every installed skill). Re-run after updating drawio-dev to pick up new or changed shapes.