Skip to content

excalidraw-mcp

MCP server for Excalidraw

3,847
Weekly Downloads
build.protocol_tooling.mcp#mcp#excalidraw#model-context-protocol#ai#drawing

Install excalidraw-mcp in your MCP client

excalidraw-mcp is a Model Context Protocol server. Add it to your MCP client config once, restart, and the server's tools become available to your AI assistant. The same JSON snippet below works across all four major clients — only the config file path differs.

  1. Locate your client's MCP config file.
    • Cursor: ~/.cursor/mcp.json
    • Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
    • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
    • VS Code: Settings → Extensions → MCP
    • Windsurf: Settings → MCP Servers
  2. Add excalidraw-mcp to the mcpServers map — paste the snippet below into your config file. If you already have other MCP servers, merge the entry into the existing mcpServers object.
  3. Restart your client so it picks up the new server.
  4. Verify — ask the assistant to list available tools; excalidraw-mcp's tools should appear.
{
  "mcpServers": {
    "excalidraw-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "excalidraw-mcp"
      ]
    }
  }
}

Install excalidraw-mcp in Cursor

Open ~/.cursor/mcp.json in your editor, paste the snippet above into mcpServers, save, and restart Cursor. excalidraw-mcp will show up in the assistant's tool list on next launch.

Install excalidraw-mcp in Claude Desktop (macOS)

Open ~/Library/Application Support/Claude/claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (macOS). excalidraw-mcp will show up in the assistant's tool list on next launch.

Install excalidraw-mcp in Claude Desktop (Windows)

Open %APPDATA%\Claude\claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (Windows). excalidraw-mcp will show up in the assistant's tool list on next launch.

Install excalidraw-mcp in VS Code

Open Settings → Extensions → MCP in your editor, paste the snippet above into mcpServers, save, and restart VS Code. excalidraw-mcp will show up in the assistant's tool list on next launch.

npm package: excalidraw-mcp

Transport

excalidraw-mcp supports the following MCP transports. Most AI clients use stdio by default for locally-installed servers.

stdio

From the excalidraw-mcp README

# Excalidraw MCP Server: Powerful Drawing API for LLM Integration > **📣 NEWS: We're excited to announce npx support!** You can now run Excalidraw MCP directly using `npx excalidraw-mcp` without installation. See Quick Start below for details. A comprehensive Model Context Protocol (MCP) server that enables seamless interaction with Excalidraw diagrams and drawings. This server provides LLMs (Large Language Models) with the ability to create, modify, query, and manipulate Excalidraw drawings through a structured, developer-friendly API. ## Quick Start You can run the Excalidraw MCP server directly using npx: ```bash npx excalidraw-mcp ``` ### Examples Run with default options: ```bash npx excalidraw-mcp ``` Enable debug logging: ```bash npx excalidraw-mcp --d

Other Model Context Protocol servers in the same space as excalidraw-mcp. Each one adds different capabilities to your AI assistant — pick based on the data sources or workflows you need.

Browse the full MCP server directory or use Stork's one-line install to let your agent pick the right server automatically.