io.github.cmd8/excalidraw-mcp

Official

by cmd8 · TypeScript

Model Context Protocol server for Excalidraw diagrams.

@cmd8/excalidraw-mcp Model Context Protocol Server

Model Context Protocol (MCP) server for Excalidraw diagrams. It provides an MCP server endpoint tied to supplying an Excalidraw diagram file via a command-line argument. The repo slug is io.github.cmd8/excalidraw-mcp, with topics including excalidraw, mcp, and modelcontextprotocol.

🛠️ Key Features

MCP server for Excalidraw diagrams
Uses --diagram to pass a diagram file path
Distributed as an npm package (@cmd8/excalidraw-mcp)

🚀 Use Cases

Integrate Excalidraw diagram context into MCP-capable clients
Configure Cursor MCP via ~/.cursor/mcp.json
Add the server to Claude Code using claude mcp add

⚡ Developer Benefits

Requires Node.js >= v18.0.0
Uses npx with -y to run the package
Example commands provided for Cursor and Claude Code

⚠️ Limitations

Installation examples shown, but no additional MCP tools or capabilities are specified in the provided data.

Topics

excalidrawmcpmcp-servermcpservermodelcontextprotocol

README.md2 KBView on GitHub

@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):

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:

json

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

Install in Windsurf

Add to your Windsurf MCP config:

json

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

Install in Claude Desktop

Add to your claude_desktop_config.json:

json

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

Install in OpenAI Codex

Add to your Codex MCP config:

toml

[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

Install

Configuration

Arguments

diagramrequired

/path/to/diagram.excalidraw

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "excalidraw-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@cmd8/excalidraw-mcp@1.2.0",
        "<YOUR_DIAGRAM>"
      ]
    }
  }
}

@cmd8/excalidraw-mcp Model Context Protocol Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

@cmd8/excalidraw-mcp

🛠️ Installation

Requirements

CLI Options

🔨 Available Tools

createNode

createEdge

deleteElement

getFullDiagramState

License

Install

Configuration

Related servers

`createNode`

`createEdge`

`deleteElement`

`getFullDiagramState`