home / mcp / excalidraw mcp app server

Excalidraw MCP App Server

Streams hand-drawn Excalidraw diagrams with smooth viewport control and fullscreen editing for MCP clients.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "2gavy-excalidraw-mcp1": {
      "url": "https://excalidraw-mcp-app.vercel.app/mcp"
    }
  }
}

The Excalidraw MCP App Server streams hand-drawn diagrams with smooth viewport controls and interactive fullscreen editing, enabling you to embed dynamic Excalidraw drawings inside MCP-compatible clients for rich, visual conversations.

How to use

You can use this MCP server from any MCP-enabled client, such as Claude, ChatGPT, VS Code, Goose, or similar tools. Add the server as an MCP endpoint and start drawing, editing, and viewing Excalidraw diagrams inside your chat or editor. For best results, use the remote URL first and switch to a local setup if you need offline or custom deployments.

How to install

Prerequisites: Node.js and a modern MCP-enabled client. If you plan to run locally, you will also build the project from source.

Remote (recommended) setup steps:

https://excalidraw-mcp-app.vercel.app/mcp

Local setup options: either install the extension or build from source.

Option A: Install extension (local) by downloading the MCP bundle and installing it in your client.

Option B: Build from source

git clone https://github.com/antonpk1/excalidraw-mcp-app.git
cd excalidraw-mcp-app
npm install && npm run build

After building, configure your client to launch the local server. For Claude Desktop, add the following MCP server configuration to the client settings.

{
  "mcpServers": {
    "excalidraw": {
      "command": "node",
      "args": ["/path/to/excalidraw-mcp-app/dist/index.js", "--stdio"]
    }
  }
}

Additional sections

MCP Apps let servers return interactive HTML interfaces that render directly in the chat. This Excalidraw MCP App Server provides a hands-on drawing environment that users can manipulate within supported clients, including streaming updates and fullscreen editing.

Deploying your own instance on a hosting platform is straightforward and allows you to customize endpoints and environment. The server can be hosted as a remote MCP service or run locally from source.

If you choose to deploy to a platform like Vercel, you can publish your own copy and expose it at a URL under the platform’s domain, then point your MCP client to that URL.

Notes and troubleshooting

Restart your client after adding the new MCP endpoint to ensure the server is recognized. If something doesn’t work as expected, open an issue with details about your client, the MCP URL, and the steps you took.

Available tools

stream_diagrams

Streams hand-drawn diagrams from Explication to clients with smooth viewport camera control.

fullscreen_editor

Provides fullscreen editing mode within the MCP client for immersive drawing sessions.

viewport_control

Offers interactive camera and viewport controls to pan, zoom, and navigate the drawing canvas.