excalidraw-mcp README

The project's README from github.com/excalidraw/excalidraw-mcp. As one markdown file: README.md.

Excalidraw MCP App Server

MCP server that streams hand-drawn Excalidraw diagrams with smooth viewport camera control and interactive fullscreen editing.

Demo

Install

Works with any client that supports MCP Apps — Claude, ChatGPT, VS Code, Goose, and others. If something doesn't work, please open an issue.

https://mcp.excalidraw.com

For apps that don't yet have an official integration, you can add a custom MCP / connector (naming can vary between apps).

Local

Option A: Download Extension

  1. Download excalidraw-mcp-app.mcpb from Releases
  2. Double-click to install in Claude Desktop

Option B: Build from Source

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

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Restart Claude Desktop.

Usage

Example prompts:

What are MCP Apps and how can I build one?

Text responses can only go so far. Sometimes users need to interact with data, not just read about it. MCP Apps is an official Model Context Protocol extension that lets servers return interactive HTML interfaces (data visualizations, forms, dashboards) that render directly in the chat.

Contributing

PRs welcome! See Local above for build instructions.

Deploy your own instance

You can deploy your own copy to Vercel in a few clicks:

  1. Fork this repo
  2. Go to vercel.com/new and import your fork
  3. No environment variables needed — just deploy
  4. Your server will be at https://your-project.vercel.app/mcp

Release checklist

For maintainers 
# 1. Bump version in manifest.json and package.json
# 2. Build and pack
pnpm run build && mcpb pack .

# 3. Create GitHub release
gh release create v0.3.0 excalidraw-mcp-app.mcpb --title "v0.3.0" --notes "What changed"

# 4. Deploy to Vercel
vercel --prod

Credits

Built with Excalidraw — a virtual whiteboard for sketching hand-drawn like diagrams.

License

MIT

excalidraw-mcp (excalidraw/excalidraw-mcp)

Searching Database…

5.5K ·GitHub
Excalidraw-mcp
Что это такое?Это MCP-сервер, который позволяет ИИ-ассистенту рисовать интерактивные диаграммы Excalidraw в стиле рисунка от руки прямо в чате, с плавным перемещением и масштабированием камеры и полноэкранным режимом редактирования.
Это просто текстовый MCP-инструмент или что-то более наглядное?Это MCP App — более новое расширение MCP, в котором сервер возвращает интерактивный HTML-интерфейс, который отображается прямо в чате, а не обычный текст.
Как это запустить?Рекомендуемый способ — добавить удалённый сервер в любой клиент с поддержкой MCP Apps. Для локальной настройки можно скачать расширение excalidraw-mcp-app.mcpb из раздела Releases и дважды щёлкнуть по нему, чтобы установить в Claude Desktop, либо собрать его из исходного кода.
Какие клиенты могут это использовать?Любой клиент, который поддерживает расширение MCP Apps; в README в качестве примеров перечислены Claude, ChatGPT, VS Code и Goose.
В чём подвох, если мой клиент пока официально не поддерживается?Для приложений без официальной интеграции нужно добавить сервер вручную как пользовательский MCP-коннектор, а название этой опции у каждого приложения своё, поэтому всё не всегда делается в один клик.
Что такое сам Excalidraw?Excalidraw — это виртуальная доска для набросков диаграмм в рукописном стиле. Этот MCP-сервер построен на его основе и открывает эту рабочую поверхность для ИИ-ассистентов.
Можно ли развернуть свою копию вместо использования общего экземпляра?Да — можно сделать форк репозитория и развернуть собственный экземпляр на Vercel буквально в несколько кликов, без необходимости задавать переменные окружения.
Какие запросы можно ему давать?Примеры запросов: «Нарисуй милого кота с помощью excalidraw» или «Нарисуй архитектурную диаграмму: пользователь подключается к API-серверу, который обращается к базе данных».
Какой стек технологий используется внутри?Это проект на TypeScript/Node с использованием Express, React, Vite и официального MCP SDK, а также необязательного Redis (через Upstash) для хранения состояния.
What are similar projects?rankme.fast, next-ai-draw-io, growth-engineer, evenfire, boardui, smart-excalidraw-next, NextChat, commerce-agents
Which topics is it in?diagrams, vercel, express, vite, redis, data-visualization, model-context-protocol, anthropic, mcp-server, claude, ai-agent, react
Creator
excalidraw
Size
29.9 MB
Stars
5.5K
Updated
CommitMar 24Releasev0.3.2Feb 09
Age
8mo
Commits · 90 Days