Draw.io MCP server
✓ OfficialEnables AI assistants to create, read, and update technical diagrams like AWS architecture and flowcharts using natural language.
Also known as aws-samples/sample-drawio-mcp
- Stars
- 25
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- May 23, 2026
- License
- MIT-0
What is Draw.io MCP?
Draw.io enables AI assistants to create, read, and update technical diagrams like AWS architecture and flowcharts using natural language.
Summary generated from the project's README
About Draw.io MCP server
Generating technical diagrams like AWS architecture, Kubernetes layouts, or network topologies through natural language is possible with this tool. It allows AI assistants to build, read, and modify draw.io files directly on your local machine. By using the DrawIO JSAPI to manipulate mxGraph XML structures, the server translates text descriptions into visual diagrams containing official icons.
Developers can integrate this server into clients like Claude Desktop, Claude Code, or Kiro using a standard npx command configuration. Because all operations run locally, your diagram data and telemetry never leave your computer. This setup works in both Node.js and browser environments, providing a way to programmatically update existing diagrams or create new ones from scratch without manual drawing.
What you can do with it
- 1Generate AWS architecture diagramsAsk an AI assistant to build a complex serverless infrastructure diagram using specific AWS services and VPC structures.
- 2Modify existing technical drawingsInstruct an AI to programmatically change or update components within a previously created diagram.
- 3Create flowcharts via natural languageDescribe a process in plain English to have the assistant generate a corresponding flowchart.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableaws-samples/sample-drawio-mcp is public and reachablegithub.com/aws-samples/sample-drawio-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MIT-0spdx.org/licenses/MIT-0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-05-23github.com/aws-samples/sample-drawio-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub🎨 Draw.io MCP Server
[!WARNING] Pre-Release Alpha Software: This software is in an early stage of development and may contain defects. Please open issues at github.com/aws-samples/sample-drawio-mcp/issues — we welcome bug reports and accept PRs.
Create, read, and update draw.io diagrams programmatically using AI assistants.
🚀 What is This?
The draw.io MCP server enables AI assistants to build technical diagrams on your local computer through natural language. Ask for an AWS architecture diagram, a flowchart, or a network topology—and watch it appear in draw.io format.
🏗️ Architecture
The project consists of two main components:
- DrawIO JSAPI - A JavaScript/TypeScript library that manipulates mxGraph XML structures
- MCP Server - A Model Context Protocol server that exposes diagram operations to AI assistants
The JSAPI operates independently of draw.io or mxGraph runtime dependencies, working in both Node.js and browser environments.
🔒 Privacy First
All operations run entirely on your local machine. No diagram data, telemetry, or information is transmitted over the network.
✨ Key Features
- 📊 Create architecture diagrams with AWS, Kubernetes, and more icons!
- 🔄 Programmatically modify existing diagrams
- 🎯 Natural language diagram creation through AI assistants
- 🌐 Works in Node.js and browser environments
- 🔐 100% local operation with no network dependencies
🎯 Quick Example
You: "Create an AWS serverless architecture diagram with CloudFront, API Gateway,
container-based Lambda (pulling from ECR), connecting to Aurora PostgreSQL,
OpenSearch, S3, and Bedrock. Include Cognito for authentication, IAM roles,
and CodePipeline for deployment. Show the VPC and private subnet structure."
AI: [Generates a properly formatted draw.io diagram with official AWS icons]

Example AWS architecture diagram generated by the MCP server. The resulting .drawio file can be edited manually in draw.io or programmatically by AI assistants like Kiro.
Getting Started
MCP Client Configuration
Add to your MCP client config (Claude Desktop, Claude Code, Kiro):
{
"mcpServers": {
"drawio": {
"command": "npx",
"args": [
"-y",
"https://github.com/aws-samples/sample-drawio-mcp/releases/latest/download/drawio-mcp-server-latest.tgz",
"--no-cache"
],
"type": "stdio"
}
}
}
See the full Installation Guide for version pinning, platform-specific config paths, and building from source.
📚 Documentation
- JSAPI - JavaScript API documentation for programmatic diagram creation
- Examples - Working code examples and tutorials
- Contributing - Guidelines for contributing to the project
Draw.io MCP questions
Is my diagram data private?
Yes, all operations run locally on your machine with no data or telemetry transmitted over the network.
What kind of diagrams can I create?
You can create technical diagrams such as AWS architecture, Kubernetes diagrams, flowcharts, and network topologies.
Does it require an internet connection to process diagrams?
No, it features 100% local operation with no network dependencies.