mcp-excalidraw-server
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Returns a result when called with no setup: 3 of 3 tools tried
Contacts while installing and starting: nothing
What it contacted
Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.
Starting it
npx -y -p mcp-excalidraw-server@2.2.0 mcp-excalidraw-server
Installing a package runs its code. Use a sandbox for anything you have not read.
Calling its tools
3 tools that take no input and look read-only were called once with nothing. 3 returned a result.
get_selection | Returned a result under 0.1 s · 44 characters |
describe_scene | Returned a result under 0.1 s · 45 characters |
read_diagram_guide | Returned a result under 0.1 s · 4,300 characters |
During the calls it contacted nothing it had not already contacted.
Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
create_element id, type, x, y, width, height, backgroundColor, strokeColor, strokeWidth, strokeStyle, roughness, opacity, text, fontSize, fontFamily, startElementId, endElementId, endArrowhead, startArrowhead
Create a new Excalidraw element. For arrows, use startElementId/endElementId to bind to shapes (auto-routes to edges).
update_element id, type, x, y, width, height, backgroundColor, strokeColor, strokeWidth, strokeStyle, roughness, opacity, text, fontSize, fontFamily
Update an existing Excalidraw element
delete_element id
Delete an Excalidraw element
query_elements type, filter, bbox
Query Excalidraw elements with optional filters
get_resource resource
Get an Excalidraw resource
22 more tools
group_elements elementIds
Group multiple elements together
ungroup_elements groupId
Ungroup a group of elements
align_elements elementIds, alignment
Align elements to a specific position
distribute_elements elementIds, direction
Distribute elements evenly
lock_elements elementIds
Lock elements to prevent modification
unlock_elements elementIds
Unlock elements to allow modification
create_from_mermaid mermaidDiagram, config
Convert a Mermaid diagram to Excalidraw elements and render them on the canvas
batch_create_elements elements
Create multiple Excalidraw elements at once. For arrows, use startElementId/endElementId to bind arrows to shapes — Excalidraw auto-routes to element edges. Assign custom id to shapes so arrows can reference them.
get_element id
Get a single Excalidraw element by ID
get_selection
Get the IDs of currently selected elements on the canvas
clear_canvas
Clear all elements from the canvas
export_scene filePath
Export the current canvas to .excalidraw JSON format. Optionally write to a file; a path ending in .md is written in the Obsidian Excalidraw plugin format (.excalidraw.md).
import_scene filePath, data, mode
Import elements and image files from .excalidraw JSON, Obsidian .excalidraw.md, a PNG with an embedded Excalidraw scene, or raw JSON data
export_to_image format, filePath, background, renderer, dark, scale, padding, elementIds, frameId, embedScene
Export the current canvas to a PNG or SVG image. Renders headless in the canvas server (no browser tab needed); SVGs embed fonts. Set embedScene: true for a PNG that is also editable in Excalidraw.
duplicate_elements elementIds, offsetX, offsetY
Duplicate elements with a configurable offset
snapshot_scene name
Save a named snapshot of the current canvas state for later restoration
restore_snapshot name
Restore the canvas from a previously saved named snapshot
describe_scene
Get an AI-readable description of the current canvas: element types, positions, connections, labels, spatial layout, and bounding box. Use this to understand what is on the canvas before making changes.
get_canvas_screenshot background, renderer, dark, scale, padding, elementIds, frameId, embedScene
Render the current canvas to a PNG and return it as an image. Renders headless in the canvas server (no browser tab needed). Use this to visually verify what the diagram looks like.
read_diagram_guide
Returns a comprehensive design guide for creating beautiful Excalidraw diagrams: color palette, sizing rules, layout patterns, arrow binding best practices, diagram templates, and anti-patterns. Call this before creating diagrams to produce professional results.
export_to_excalidraw_url
Export the current canvas to a shareable excalidraw.com URL. The diagram is encrypted and uploaded; anyone with the URL can view it. Returns the shareable link.
set_viewport scrollToContent, scrollToElementIds, viewportZoomFactor, scrollToElementId, zoom, offsetX, offsetY
Control the canvas viewport (camera). Auto-fit all elements, zoom-to-fit a subset of elements, center on a specific element, or set zoom/scroll directly. Requires the canvas frontend open in a browser.
Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Files it wrote
/tmp/ .local/ state/ excalidraw-mcp/ excalidraw.log /tmp/ .local/ state/ excalidraw-canvas/ server-3000.pid
Paths inside its sandbox, where its home folder is /tmp and its own folder cannot be written to.
Install facts
| License | MIT |
|---|---|
| Needs | node >=20.0.0 |
| Source | github.com/yctimlin/mcp_excalidraw |
| Install scripts | None declared by it or anything installed with it. |
| Tarball | sha512-hgvg8Q8o05YtY8vJk7XT6K+p7uoADR/g6iRq0Y61iBA9j6eIZRpNIeeqD7vg3Lwk/zfS+lfYVcYAZemPl8N9Zw== |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/mcp-excalidraw-server)
New version out? Ask for a fresh report.