Skip to main content
Glama

excalidraw-ai — MCP server (AI interface to Excalidraw)

The clean, non-clunky interface for an AI to read, watch, and edit a live Excalidraw room. Instead of browser automation (fiber-read + drag-drop + remote browser drops), it joins the room as a socket-bot over the collab relay and speaks the AES-GCM-encrypted scene protocol directly — deterministic, headless, scalable.

POC status: core bridge + MCP stdio surface working end-to-end against a self-hosted excalidraw-room relay (selftest + MCP smoke pass).

Why a relay we control

The bot talks to a relay. Excalidraw's hosted relay (oss-collab.excalidraw.com) origin-guards non-browser bots (403/400), so for our own rooms we run excalidraw/excalidraw-room (MIT, same code as prod) and point an Excalidraw UI at it via VITE_APP_WS_SERVER_URL.

Related MCP server: Excalidraw MCP Server

Architecture

Excalidraw UI (fork) ──socket.io──▶ relay (excalidraw-room) ◀──socket-bot── excalidraw-ai (MCP)
   (humans)                           self-hosted                 (the AI's interface)

Tools

Tool

What it does

create_room

new room id/key for our relay

join_room

join a room, read scene, start listening

leave_room

disconnect

get_scene

board elements + texts

get_changes

add/update/remove deltas since last call ("hear the room")

add_elements

append elements (broadcast live)

update_elements

move / retitle / recolor existing (version bump)

delete_elements

mark deleted

Run

npm install
# relay (one terminal):
cd /tmp/excalidraw-room && PORT=3002 node dist/index.js
# self-test the bridge core:
npm run selftest
# MCP smoke (stdio handshake + join + get_scene):
npm run mcp-smoke
# start the MCP server (stdio) — wire into Hermes/Copilot/Claude:
node src/server.js

Wire into Hermes (~/.hermes/config.yaml)

mcp_servers:
  excalidraw_ai:
    command: "node"
    args: ["/root/workspace/mcclawd-org/excalidraw-ai/src/server.js"]

Restart Hermes → tools appear as mcp_excalidraw_ai_*.

Layout

  • src/crypto.js — AES-GCM E2E helpers (Node Web Crypto)

  • src/elements.js — element builders + scene merge/diff (id+version semantics)

  • src/room.js — RoomClient: socket join, read, write, change feed

  • src/server.js — MCP server (stdio), tool registration

  • scripts/selftest.mjs, scripts/mcp-smoke.mjs — verification

F
license - not found
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    F
    maintenance
    Enables AI agents to programmatically control a live Excalidraw canvas through element-level CRUD operations and real-time synchronization. It allows agents to iteratively build, inspect, and refine diagrams while providing visual feedback via screenshots and scene descriptions.
    1,730
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    Enables AI agents to programmatically control a live Excalidraw canvas with element-level CRUD operations and real-time synchronization. It supports iterative diagramming through scene descriptions, screenshots, and advanced layout tools for collaborative AI-human workflows.
    1,730
    MIT

View all related MCP servers

Related MCP Connectors

  • Ephemeral REST chatrooms for AI agents to coordinate. Share a room URL — agents talk live.

  • Real-time collaborative whiteboard — AI agents and humans edit the same board live over MCP.

  • Persistent docs and memory for AI agents — read, write, organize & search a shared workspace.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/McClawdDigital/excalidraw-ai'

If you have feedback or need assistance with the MCP directory API, please join our Discord server