Excalidraw Mcp

cmd8/excalidraw-mcp

This server gives Claude direct access to your Excalidraw diagram files through stdio transport. It exposes three core operations: createNode for adding labeled shapes, createEdge for drawing arrows between nodes (referenced by ID or label text), and deleteElement for removing items. You also get getFullDiagramState, which returns a markdown representation of everything in your diagram including frames and colors. Point it at an .excalidraw file via the required diagram flag, and you can have Claude build or modify technical diagrams conversationally instead of clicking around the canvas. Useful when you're sketching architecture or workflows and want to iterate through natural language rather than manual editing.

GitHub stars: 4
tools: 2
transport: STDIO
last updated: Nov 29, 2025

View on GitHub

Tools

2 tools

Public tool metadata for what this MCP can expose to an agent.

read_meReturns the Excalidraw element format reference with color palettes, examples, and tips. Call this BEFORE using create_view for the first time.

Returns the Excalidraw element format reference with color palettes, examples, and tips. Call this BEFORE using create_view for the first time.

No parameter schema in public metadata yet.

create_viewRenders a hand-drawn diagram using Excalidraw elements. Elements stream in one by one with draw-on animations. Call read_me first to learn the element format.1 params

Renders a hand-drawn diagram using Excalidraw elements. Elements stream in one by one with draw-on animations. Call read_me first to learn the element format.

Parameters* required

elementsstring

JSON array string of Excalidraw elements. Must be valid JSON — no comments, no trailing commas. Keep compact. Call read_me first for format reference.

Readme

@cmd8/excalidraw-mcp

Model Context Protocol (MCP) server for Excalidraw diagrams.

🛠️ Installation

Requirements

Node.js >= v18.0.0

Install in Cursor

Add to your Cursor MCP config (~/.cursor/mcp.json):

{
  "mcpServers": {
    "excalidraw": {
      "command": "npx",
      "args": ["-y", "@cmd8/excalidraw-mcp", "--diagram", "/path/to/diagram.excalidraw"]
    }
  }
}

Install in Claude Code

claude mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp --diagram /path/to/diagram.excalidraw

Install in Amp

amp mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp --diagram /path/to/diagram.excalidraw

Install in VS Code

Add to your VS Code MCP settings:

{
  "mcp": {
    "servers": {
      "excalidraw": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@cmd8/excalidraw-mcp", "--diagram", "/path/to/diagram.excalidraw"]
      }
    }
  }
}

Install in Windsurf

View the full README on GitHub

Details

Repository: github.com/cmd8/excalidraw-mcp
Category: Design & Creative
Package: @cmd8/excalidraw-mcp
Transport: STDIO
Registry: MCP registry, active

Related Design & Creative MCP servers

View all

Figma Context Mcpfelixanhalt/figma-context-mcpLLM-optimized Figma MCP server.3stars

Excalidrawdebu-sinha/excalidraw-mcp-serverSecurity-hardened Excalidraw MCP server with auth, rate limiting, and 14 tools3stars

Figma MCP Serveroabolade/figma_mcp_server_actorMCP server enabling AI assistants to interact with Figma designs via natural language commands1stars

Vaults Diagram Toolsmalnati/vaults-diagram-toolsMermaid to assets. Source code to maps. MCP for agents.0stars

VoltPlan Wiring Diagramsyuzu-hub/wiring-diagram-mcpGenerate 12V/24V/48V wiring diagrams and size wires, fuses, batteries, solar, and inverters.0stars

Blenderahujasid/blender-mcpConnects Blender to Claude AI via MCP, enabling scene inspection, object manipulation, material control, and code execution from Claude.21.7Kstars