Whiteboard MCP

Tableau blanc Excalidraw local sur lequel votre agent de codage dessine en direct et voit ce que vous dessinez en retour. Gratuit, open source, fonctionne hors ligne.

Documentation

Whiteboard MCP: a live whiteboard your coding agent draws on. You draw back.

https://github.com/user-attachments/assets/197876d8-5620-4c1b-9bc3-332e0e7d5622

Whiteboard MCP is a free and extremely token-efficient whiteboard MCP that runs locally. Your coding agent draws diagrams on a live board beside the chat, and sees what you draw back.

One command install for every agent ↓


Features

Why Whiteboard MCP: draws step by step, sees what you draw, right beside the chat, remembers boards, local and private, tiny (one runtime dependency, about 7 KB of tool schema per turn).

What you can do with it

Understand an architecture

An agent chat beside a live whiteboard: the agent draws a checkout architecture step by step, the human drags Postgres, circles the queue and sends a note asking what happens if the email worker is down, and the agent reads the changes and adds a dead-letter queue

Explain a flow

The agent draws a login flow step by step, highlights the parts it explains, then answers a note left by the human

Play games

Playing Dots and Boxes with a coding agent: the human draws a line on the board, the agent sees the move and plays back, until red wins 12 to 4

Make something

An agent paints the Mona Lisa on the board, then refines the sky, hair and dress with pencil strokes

Quick start

Get started in a minute: 1. Add it to your agent with one npx line. 2. Start a new chat. 3. Ask for a drawing.

Add it to your agent

# Claude Code
claude mcp add whiteboard --scope user -- npx -y @ansuman-shukla/whiteboard-mcp

# Codex CLI
codex mcp add whiteboard -- npx -y @ansuman-shukla/whiteboard-mcp

# Gemini CLI
gemini mcp add --scope user whiteboard npx -y @ansuman-shukla/whiteboard-mcp

# Devin CLI
devin mcp add whiteboard --scope user -- npx -y @ansuman-shukla/whiteboard-mcp

# VS Code
code --add-mcp '{"name":"whiteboard","command":"npx","args":["-y","@ansuman-shukla/whiteboard-mcp"]}'

Cursor, Claude Desktop, Windsurf and other JSON configs (~/.cursor/mcp.json, Claude Desktop's config, …):

{ "mcpServers": { "whiteboard": { "command": "npx", "args": ["-y", "@ansuman-shukla/whiteboard-mcp"] } } }

OpenCode (opencode.json):

{ "mcp": { "whiteboard": { "type": "local", "command": ["npx", "-y", "@ansuman-shukla/whiteboard-mcp"] } } }

Agents without MCP, project-level configs and more: client setup. The bundled skill teaches the agent when a drawing helps.

Whiteboard MCP vs Excalidraw MCP

Whiteboard MCP vs Excalidraw MCP: Whiteboard MCP sees what you draw back as a short list of changes, screenshots its own board, edits one shape in place, keeps boards beyond the chat, works in any MCP client plus a CLI, and converts Mermaid. Excalidraw MCP has animated camera moves and zero install.

Want a quick one-off diagram inside Claude or ChatGPT on the web? Excalidraw MCP is great for that. Full comparison →


Client setup · Boards · IDE panel · Tools & how it works · Configuration · Security · Contributing
MIT License · built on Excalidraw