@cmd8/excalidraw-mcp
MCP serverAI & modelsThis gives your AI the ability to create and work with Excalidraw diagrams. Describe what you want drawn and get a diagram back, or have your AI read, explain, and update diagrams you already have. Everything comes out as an Excalidraw diagram you can open in Excalidraw.
Unavailable. This server has no hosted endpoint yet, so ahel can't serve it.
After adding it, ask your AI to sketch something, like your team's workflow or a plan you have in mind. You can also point it at an Excalidraw diagram you already have and ask for changes.
What your AI can do with it
- Create Excalidraw diagrams from a description in chat
- Read existing Excalidraw diagrams
- Explain what a diagram shows in plain language
- Edit or update a diagram when you ask
- Turn ideas discussed in chat into a drawn diagram
From the project's README
As published by cmd8/excalidraw-mcp in README.md.
Model Context Protocol (MCP) server for Excalidraw diagrams.
🛠️ Installation
Requirements
- Node.js >= v18.0.0
Add to your Cursor MCP config (~/.cursor/mcp.json):
{
"mcpServers": {
"excalidraw": {
"command": "npx",
"args": ["-y", "@cmd8/excalidraw-mcp", "--diagram", "/path/to/diagram.excalidraw"]
}
}
}
claude mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp --diagram /path/to/diagram.excalidraw
amp mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp --diagram /path/to/diagram.excalidraw
Add to your VS Code MCP settings:
{
"mcp": {
"servers": {
"excalidraw": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@cmd8/excalidraw-mcp", "--diagram", "/path/to/diagram.excalidraw"]
}
}
}
}
Add to your Windsurf MCP config:
{
"mcpServers": {
"excalidraw": {
"command": "npx",
"args": ["-y", "@cmd8/excalidraw-mcp", "--diagram", "/path/to/diagram.excalidraw"]
}
}
}
Add to your claude_desktop_config.json:
{
"mcpServers": {
"excalidraw": {
"command": "npx",
"args": ["-y", "@cmd8/excalidraw-mcp", "--diagram", "/path/to/diagram.excalidraw"]
}
}
}
Add to your Codex MCP config:
[mcp_servers.excalidraw]
command = "npx"
args = ["-y", "@cmd8/excalidraw-mcp", "--diagram", "/path/to/diagram.excalidraw"]
CLI Options
-d, --diagram(required): Path to the Excalidraw diagram file
🔨 Available Tools
createNode
Create a new node (shape with label) in the diagram. Returns the created node ID.
createEdge
Create an arrow connecting two nodes. Nodes can be referenced by ID or by label text.
deleteElement
Delete a node or edge from the diagram by ID or label.
getFullDiagramState
Returns a markdown representation of the complete diagram, including nodes, relationships, labels, frames, and colors.
License
MIT
Signals
- GitHub stars
- 5
- Forks
- 2
- Last commit
- Nov 2025
Advanced
- Delivery
- excalidraw-mcp MCP server → your ahel gateway (mcp.ahel.ai) → every connected AI client.
- Catalog kind
- mcp-server
- Gateway key
io-github-cmd8-excalidraw-mcp- Source
- github.com/cmd8/excalidraw-mcp