sketchboard-excalidraw-mcp
Currently, the server is mostly a scaffold: you can query its status and see registered tools, but the rendering/conversion/batch tools return not_implemented.
status: reports the server identity, version, and which capability groups are wired up.render_svg: registered to render Excalidraw element JSON to SVG, but currently returnsnot_implemented.mermaid_to_excalidraw: registered to convert Mermaid source to Excalidraw elements, but currently returnsnot_implemented.batch_render: registered to batch-render README diagrams across a list of repos, but currently returnsnot_implemented.
Allows creation and rendering of Excalidraw diagrams, including interactive canvas authorship and headless generation of SVG/PNG from Excalidraw element JSON.
Converts Mermaid diagrams to Excalidraw format for editing and rendering within the server (planned).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@sketchboard-excalidraw-mcp draw a simple network topology diagram"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
# sketchboard-excalidraw-mcp
Excalidraw canvas authorship + headless-render MCP server. Slots next to inkscape-mcp and gimp-mcp as the vector/raster/diagram trio in the fleet.
Status: day 2. Server shell, package layout, and fleet standardization
are in place. Headless rendering (render_svg/render_png) is real and
tested. Canvas bridging, Mermaid conversion, and batch rendering are
registered as MCP tools but return not_implemented - see docs/DESIGN.md
for what's real vs planned.
What this is
A merge of two upstream approaches into one fleet-standard server:
Canvas workbench (planned base: fork of lesleslie/excalidraw-mcp, itself built on yctimlin/mcp_excalidraw): Python FastMCP server + TypeScript canvas server + React frontend for live, interactive diagram authorship. Not merged in yet - both upstreams are cloned for reference/cherry-picking under
D:\Dev\repos\external\, but no canvas-bridge code has been ported into this repo. See the fork-drift open question indocs/DESIGN.mdbefore that lands.Headless rendering (real, implemented): ported from bassimeledath/excalidraw-render-mcp's TypeScript/agent-browser renderer into Python/Playwright, rather than vendoring a second Node stack. A warm Chromium instance renders Excalidraw element JSON to SVG/PNG via
exportToSvg, reused across calls in the same process. Known gap: still loads@excalidraw/excalidrawfrom esm.sh at runtime rather than a locally vendored bundle, so it needs network access on first render and isn't version-pinned yet.
The two modes are deliberately decoupled: headless render tools work without the canvas server running (agent batch mode), while the canvas/Tauri app is for interactive human use. Both talk to the same backend; the desktop app is not a sidecar wrapping the Python server.
Related MCP server: excalidraw-export-mcp
Fork sources on this machine
Both upstream forks were cloned for reference/cherry-picking, not vendored wholesale:
D:\Dev\repos\external\excalidraw-mcp-lesleslie\D:\Dev\repos\external\excalidraw-render-bassimeledath\
Planned extras
Mermaid-to-Excalidraw conversion, wrapping the official
@excalidraw/mermaid-to-excalidrawnpm package rather than reimplementing Mermaid parsing..excalidrawlibsupport for reusable fleet-diagram components (server boxes, transport arrows).Batch-render command for the repo-README diagram pipeline across the fleet (~200 repos).
Ports
Port | Service |
11107 | Backend (FastMCP HTTP |
11108 | Frontend (Vite React canvas) |
Registered in mcp-central-docs/operations/WEBAPP_PORTS.md.
License and attribution
MIT, same as both upstream sources. Credit chain: this project builds on
lesleslie/excalidraw-mcp (which credits yctimlin/mcp_excalidraw) and borrows
the headless-render architecture from bassimeledath/excalidraw-render-mcp.
Font licensing (Excalidraw's default hand-drawn fonts ship under SIL OFL, not
MIT) is tracked separately in NOTICE.md once the JS bundle is vendored.
Development
uv sync
uv run pytest
just release-drySee docs/DESIGN.md for the day 1/2/3 build plan and the concrete technical
decisions behind this scaffold.
Available Tools
4 toolsbatch_renderA
Batch-render README diagrams across a list of fleet repos.
NOT IMPLEMENTED YET. Day 2/3 work: browser-context pool over the one warm Chromium instance (not one page reused sequentially), so a 200-repo run doesn't serialize behind a single tab.
Return Format
{"success": False, "error": str, "error_type": "not_implemented", "suggestions": list[str]}
Inputs: output_dir (required), repo_list_path (required). Returns: object
mermaid_to_excalidrawA
Convert a Mermaid diagram to Excalidraw elements and optionally render it.
NOT IMPLEMENTED YET. Planned to wrap the official @excalidraw/mermaid-to-excalidraw npm package via a small Node/Bun shim rather than reimplementing Mermaid parsing.
Return Format
{"success": False, "error": str, "error_type": "not_implemented", "suggestions": list[str]}
Inputs: output_path (required), mermaid_source (required). Returns: object
render_svgA
Render Excalidraw element JSON to SVG via headless Chromium (Playwright).
NOT IMPLEMENTED YET. Day 2 work: port bassimeledath's warm-Chromium exportToSvg approach into sketchboard_excalidraw_mcp/render.py using a locally vendored excalidraw JS bundle (no CDN dependency at runtime).
Return Format
{"success": False, "error": str, "error_type": "not_implemented", "suggestions": list[str]}
Inputs: output_path (required), elements_json (required). Returns: object
statusA
Report server identity and which capability groups are wired up yet.
This is the one real tool in the day-1 scaffold - everything else is registered but returns an explicit not_implemented result.
Return Format
{"server": str, "version": str, "capabilities": dict[str, str]}
Examples
status()
Inputs: no named parameters. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
The four tools have clearly distinct purposes: status for server info, render_svg for single-file rendering, mermaid_to_excalidraw for format conversion, and batch_render for multi-repo processing. Even though three are unimplemented, their intended roles are unambiguous and non-overlapping.
All names use snake_case and mostly follow a verb_noun pattern (render_svg, batch_render), with mermaid_to_excalidraw being a noun_to_noun exception and status being a simple noun. The pattern is mostly consistent and readable, only minor deviations.
Four tools is a well-scoped number for this server's purpose, covering status, single render, conversion, and batch processing. The count is neither too thin nor too heavy, and each tool has a clear intended role.
Three of four tools are marked NOT IMPLEMENTED YET and return explicit not_implemented errors. This creates severe dead ends for any agent attempting real diagram conversion or rendering; the only functional tool is status, leaving the server's stated purpose almost entirely unfulfilled.
Maintenance
Related MCP Connectors
Collaborative whiteboard MCP server — create objects, connectors, C4 diagrams, and manage boards
Render, verify, describe, and safely edit Mermaid diagrams through MCP.
Official Browserless MCP server: browser automation, scraping, screenshots and PDFs for AI agents.
Related MCP Servers
- AlicenseBqualityBmaintenanceAn MCP server that generates beautiful Excalidraw architecture diagrams with perfect auto-layout, stateful editing, and architecture-aware component styling.226284 PyPI163MIT
- AlicenseAqualityDmaintenanceAn MCP server that enables exporting Excalidraw .excalidraw files to PNG or SVG format, with support for batch export and metadata retrieval.3MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that streams hand-drawn Excalidraw diagrams with smooth viewport camera control and interactive fullscreen editing.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for live collaborative drawing on ExcaliDash, enabling diagram creation and editing with instant browser updates via Socket.IO.MIT