Excalidraw MCP

excalidraw/excalidraw-mcp· Проверено 12.11.2026· 5,7 тыс.на GitHub

Даёт агенту рисовать схемы в стиле Excalidraw: диаграмму прямо в окне чата по одному запросу или живой холст, где агент правит элементы, смотрит скриншот и сохраняет файл .excalidraw в проект.

2 реализации:

Рисует схему с анимацией прямо в чате как MCP App; схему можно развернуть на весь экран, поправить руками и выгрузить на excalidraw.com.

Как подключить

Что сделать до подключения

Клиент с поддержкой MCP Apps: Claude, ChatGPT, VS Code, Goose и другие

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http excalidraw https://mcp.excalidraw.com/mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.excalidraw]
url = "https://mcp.excalidraw.com/mcp"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "excalidraw": {
      "url": "https://mcp.excalidraw.com/mcp"
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "excalidraw": {
      "type": "http",
      "url": "https://mcp.excalidraw.com/mcp"
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "excalidraw": {
      "httpUrl": "https://mcp.excalidraw.com/mcp"
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "excalidraw": {
      "httpUrl": "https://mcp.excalidraw.com/mcp"
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "excalidraw": {
        "type": "remote",
        "url": "https://mcp.excalidraw.com/mcp"
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://mcp.excalidraw.com/mcp

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "excalidraw": {
      "url": "https://mcp.excalidraw.com/mcp"
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

read_meотдаёт справку по формату элементов

create_viewрисует схему из элементов Excalidraw

Локальный холст с синхронизацией: агент создаёт и правит отдельные элементы, видит результат скриншотом, переводит Mermaid в схему и сохраняет .excalidraw в репозиторий.

Как подключить

Что сделать до подключения

Node.js 20 или новее

Холст запускается сам на http://127.0.0.1:3000; откройте его в браузере, чтобы следить за рисованием

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio mcp-excalidraw \
  -- npx -y mcp-excalidraw-server

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp-excalidraw]
command = "npx"
args = ["-y", "mcp-excalidraw-server"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-excalidraw": {
      "command": "npx",
      "args": ["-y", "mcp-excalidraw-server"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-excalidraw": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-excalidraw-server"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-excalidraw": {
      "command": "npx",
      "args": ["-y", "mcp-excalidraw-server"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-excalidraw": {
      "command": "npx",
      "args": ["-y", "mcp-excalidraw-server"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-excalidraw": {
        "type": "local",
        "command": ["npx", "-y", "mcp-excalidraw-server"]
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-excalidraw": {
      "command": "npx",
      "args": ["-y", "mcp-excalidraw-server"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-excalidraw": {
      "command": "npx",
      "args": ["-y", "mcp-excalidraw-server"]
    }
  }
}

Инструменты сервера

create_elementсоздаёт элемент

batch_create_elementsсоздаёт много элементов разом

update_elementменяет элемент

delete_elementудаляет элемент

query_elementsищет элементы по условиям

align_elementsвыравнивает элементы

distribute_elementsраспределяет элементы

group_elementsгруппирует элементы

describe_sceneописывает схему текстом

get_canvas_screenshotснимает холст картинкой

get_selectionчитает выделенное на холсте

create_from_mermaidстроит схему из Mermaid

export_sceneсохраняет файл .excalidraw

import_sceneзагружает схему из файла

export_to_imageвыгружает PNG или SVG

export_to_excalidraw_urlдаёт ссылку на excalidraw.com

snapshot_sceneсохраняет снимок холста

restore_snapshotоткатывает к снимку

set_viewportподгоняет масштаб под элементы

read_diagram_guideотдаёт правила оформления схем

Показано 20 из 27.

Что попросить агента

«Нарисуй милого кота в Excalidraw»Агент вызовет read_me, затем create_view, и рисунок появится в чате

«Нарисуй схему: пользователь обращается к API-серверу, сервер ходит в базу данных»Агент вызовет create_view с прямоугольниками, подписями и стрелками

«Нарисуй архитектуру этого сервиса и сохрани в docs/arch.excalidraw»Агент вызовет batch_create_elements, проверит результат через get_canvas_screenshot и сохранит файл через export_scene

«Преврати эту диаграмму Mermaid в схему Excalidraw: <код Mermaid>»Агент вызовет create_from_mermaid при открытой вкладке холста

Для каких задач

Нарисовать схему архитектуры по словесному описанию

Перевести диаграмму Mermaid в редактируемую схему Excalidraw

Доводить схему по шагам: агент смотрит скриншот и двигает подписи и стрелки

Сохранить схему файлом .excalidraw или картинкой PNG и SVG в репозиторий

Поделиться схемой ссылкой на excalidraw.com

Ограничения

Excalidraw MCP App работает только в клиентах с поддержкой MCP Apps и отдаёт модели два инструмента: правка идёт повторной отправкой схемы с пометками удаления

Холст mcp-excalidraw-server по умолчанию хранится в памяти и очищается при перезапуске; сохранять его между запусками можно папкой EXCALIDRAW_DATA_DIR

Перевод из Mermaid требует открытой вкладки холста в браузере

Ссылка на excalidraw.com открывает схему любому, у кого есть полная ссылка

Если не работает

Холст не обновляется

Проверьте, что EXPRESS_SERVER_URL указывает на запущенный сервер холста, по умолчанию http://127.0.0.1:3000.

На PNG вместо китайских иероглифов или эмодзи квадраты

Встроенные шрифты покрывают латиницу. Поставьте нужный шрифт на машину, где работает сервер холста.

Без интернета страница холста показывает обычные шрифты

Рукописные шрифты грузятся с esm.sh. Скриншоты и выгрузка на сервере используют встроенные шрифты и не страдают.

Сервер в Docker не видит холст

Укажите EXPRESS_SERVER_URL=http://host.docker.internal:3000; на Linux добавьте --add-host=host.docker.internal:host-gateway или адрес 172.17.0.1.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Excalidraw MCP Appразработчик сервиса	Excalidraw	5,7 тыс.	HTTP	не нужен	2	24 марта 2026
mcp-excalidraw-server	yctimlin	2,6 тыс.	локально	не нужен	27	10 ноября 2026

Частые вопросы

Какой из двух серверов выбрать?

Чтобы схема появилась прямо в чате Claude или ChatGPT по одному запросу, хватит Excalidraw MCP App. Для работы в коде лучше mcp-excalidraw-server: правка отдельных элементов, скриншоты, Mermaid, файлы .excalidraw в репозитории.

Агент видит, что нарисовал?

В mcp-excalidraw-server — да: describe_scene даёт текстовое описание с координатами и связями, get_canvas_screenshot — картинку. По ним агент находит обрезанные подписи и наложения.

Нужен ли открытый браузер?

Для mcp-excalidraw-server — нет: скриншоты и выгрузка в PNG и SVG рисуются на сервере холста. Вкладка нужна только для перевода из Mermaid.

Можно поставить Excalidraw MCP App у себя?

Да: скачайте excalidraw-mcp-app.mcpb из релизов и откройте двойным щелчком в Claude Desktop или соберите из исходников и запустите node dist/index.js --stdio. Свою копию можно развернуть на Vercel без переменных окружения.

Схема в ссылке на excalidraw.com видна всем?

mcp-excalidraw-server шифрует схему AES-GCM до загрузки, ключ хранится только в части ссылки после #, сервер excalidraw.com его не видит. Открыть схему может любой, у кого есть полная ссылка.

Работает ли сервер из России?

Excalidraw MCP App работает на mcp.excalidraw.com, ключи не нужны; mcp-excalidraw-server рисует на вашем компьютере и выходит в сеть только за шрифтами с esm.sh и при публикации ссылки.

Excalidraw MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы