MCP Catalogs
← Home

excalidraw-mcp

by cmd8·★ 4·Score 38

MCP server for creating and editing Excalidraw diagrams programmatically with node and edge manipulation tools.

productivitydeveloper-toolsai-llm
1
Forks
2
Open issues
6 mo ago
Last commit
2d ago
Indexed

Overview

This MCP server provides tools to interact with Excalidraw diagrams through the Model Context Protocol. It allows creation of nodes (shapes with labels), creation of edges between nodes, deletion of elements, and retrieval of full diagram state. The server supports multiple integration methods including Claude Desktop, Cursor, VS Code, and other AI coding environments. The implementation is in TypeScript, indicating proper type safety and maintainability.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

you:Automatically generate and update Excalidraw diagrams based on system architecture documentation
you:Collaborate on diagrams by having AI agents modify elements programmatically
you:Create visualizations of code structures or system designs directly within AI assistants
you:What file formats does this server support?
you:Can I use this with AI coding assistants other than those listed?

When to choose this

Choose this MCP server when you need AI systems to interact with Excalidraw diagrams programmatically, especially if you already use Excalidraw for your visual documentation or design work.

When NOT to choose this

Don't choose this server if you need to work with diagram formats other than Excalidraw, or if you require advanced diagram manipulation features not provided by this implementation.

Tools this server exposes

4 tools extracted from the README
  • 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.

Comparable tools

drawio-mcpmermaid-mcpdiagrams.net-mcp

Installation

Installation

Claude Desktop

Add to your claude_desktop_config.json:

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

Other Clients

  • **Cursor**: Add to ~/.cursor/mcp.json
  • **Claude Code**: claude mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp --diagram /path/to/diagram.excalidraw
  • **VS Code**: Add to VS Code MCP settings with type "stdio"
  • **Amp**: amp mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp --diagram /path/to/diagram.excalidraw
  • **Windsurf**: Add to MCP config

Requires Node.js >= v18.0.0

FAQ

What file formats does this server support?
The server specifically works with .excalidraw files which are the native format for Excalidraw diagrams.
Can I use this with AI coding assistants other than those listed?
If your AI coding environment supports MCP servers, it should work with the stdio method as shown in the installation instructions.

Compare excalidraw-mcp with

excalidraw-mcp vs ultimate_mcp_serverexcalidraw-mcp vs mcp-server-chartexcalidraw-mcp vs everythingexcalidraw-mcp vs filesystemexcalidraw-mcp vs time
GitHub →

Last updated · Auto-generated from public README + GitHub signals.