English Français العربية

io.github.cmd8/excalidraw-mcp

Official registry AI and agents

Model Context Protocol server for Excalidraw diagrams.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @cmd8/excalidraw-mcp
Claude Code 
claude mcp add excalidraw-mcp -- npx -y @cmd8/excalidraw-mcp@1.2.0 '</path/to/diagram.excalidraw>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "excalidraw-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@cmd8/excalidraw-mcp@1.2.0",
                "</path/to/diagram.excalidraw>"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @cmd8/excalidraw-mcp
  2. 🛠️ Installation
  3. CLI Options
  4. 🔨 Available Tools
  5. License

@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

Add to your Windsurf MCP config:

{
  "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:

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

Install in OpenAI Codex

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

Frequently asked questions

What is io.github.cmd8/excalidraw-mcp?

Model Context Protocol server for Excalidraw diagrams.

How do I install io.github.cmd8/excalidraw-mcp?

It runs on your machine. In Claude Code: claude mcp add excalidraw-mcp -- npx -y @cmd8/excalidraw-mcp@1.2.0 '</path/to/diagram.excalidraw>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.cmd8/excalidraw-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.cmd8/excalidraw-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.cmd8/excalidraw-mcp?

It is published by cmd8. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.