Hosting

Local stdio process

Transport

stdio

Endpoint

Local process; no hosted endpoint documented

Authentication

No credentials were configured; the tested read-only tool “list_sessions” succeeded in an isolated environment. Other tools may have additional requirements.

Requirements

• Node.js 18+
• The public install config and runtime call passed; npm metadata did not declare a repository URL.

Setup steps

1. npx -y @scofieldfree/excalidraw-mcp@0.1.1

The server returned 11 tools in tools/list. Only “list_sessions” was invoked with a synthetic read-only input and succeeded.

• start_session

  Start browser preview and open Excalidraw editor interface. Multi-session support: - No sessionId: Uses default session (default) - sessionId specified: Open/Create specific session - Multiple sessions can be opened simultaneously for different diagrams After calling this tool: 1. Browser window opens automatically 2. Excalidraw editor loads 3. WebSocket realtime connection is established Please pass the same sessionId when using tools like add_elements, update_element subsequently.

  Parameters: sessionId
  01
• list_sessions

  List all currently active Excalidraw sessions.

  02
• create_diagram

  Create a new diagram or clear an existing session. This action will: 1. If a sessionId is specified, clear all elements in that session. 2. If no sessionId is specified, create a new session. 3. Reset the application state. Usage scenarios: • Starting a new project (no sessionId specified) • Clearing an existing diagram (sessionId specified) • Creating multiple independent diagrams (specify different sessionIds each time)

  Parameters: sessionId, viewBackgroundColor
  03
• delete_diagram

  Delete the specified diagram session. Note: This will completely delete the session and all its elements, and cannot be undone. If you only want to clear elements but keep the session, use create_diagram and specify the sessionId.

  Parameters: sessionId
  04
• add_elements

  Add multiple Excalidraw elements to the canvas. Supported element types: - rectangle - ellipse - diamond - arrow - text - line - freedraw - image - frame/magicframe - iframe/embeddable Style options: - strokeColor: e.g. #1e1e1e - backgroundColor: e.g. #D97706 - fillStyle: solid/hachure/cross-hatch - strokeWidth: 1-4 - roughness: 0=architect, 1=artist, 2=cartoonist Advanced options: - label: Auto-create bound text inside shape/arrow containers - start/end: Arrow endpoint binding to new or existing elements - containerId: DEPRECATED (use label instead) Multi-session support: Specify sessionId to target a specific session.

  Parameters: sessionId, elements
  05
• create_from_mermaid

  Create diagram elements from Mermaid syntax. Converts Mermaid text to Excalidraw elements through connected browser client. If browser is not connected yet, request is queued and sent after websocket ready. Returns clear errors for timeout and mermaid syntax problems.

  Parameters: sessionId, mermaidDiagram, reset
  06
• add_template_architecture

  Add a built-in architecture diagram template to the canvas. This template visualizes the MCP server architecture with grouped layers and connected arrows. By default it resets the current session before adding template elements.

  Parameters: sessionId, reset
  07
• update_element

  Update attributes of an existing element. Updatable attributes: - x, y: Position coordinates - width, height: Dimensions - strokeColor: Stroke color - backgroundColor: Background color - fillStyle: Fill style - strokeWidth: Stroke width - roughness: Roughness - opacity: Opacity - text: Text content (only for text type) Multi-session support: Specify sessionId to target a specific session.

  Parameters: sessionId, id, updates
  08
• delete_element

  Delete a specific element from the canvas. Usage scenarios: - Remove unwanted elements - Clean up temporary elements - Delete erroneously added elements Multi-session support: Specify sessionId to target a specific session.

  Parameters: sessionId, id
  09
• get_scene

  Retrieve complete information about the current diagram scene. Returns: - List of all elements - Application state - Version number - Session ID Usage scenarios: - Viewing current diagram content - Analyzing scene structure - Obtaining element IDs for updates/deletion Multi-session support: Specify sessionId to query a specific session.

  Parameters: sessionId
  10
• export_diagram

  Export the current diagram to a PNG, SVG, or JSON file. Notes: - JSON format is saved directly by the server. - PNG/SVG are generated by the browser and sent back to the server to save. - Requires start_session to be called first and the browser to be connected. Multi-session support: Specify sessionId to target a specific session.

  Parameters: sessionId, path, format
  11

This server’s available tools can vary by account, permissions, or configuration. The list shown is not its full runtime catalog.

• Runtime verification covered one read-only tool call (list_sessions); other listed tools were not individually exercised.
• The npm package metadata did not declare a repository URL; the repository link comes from the public MCP.Directory profile.

• MCP.Directory public profile

  Name, description, publisher identifier, categories, transport, tool inventory, and install configuration.

• Linked publisher repository

  Repository URL linked from the public profile; any npm repository difference is recorded separately.

• npm registry metadata

  Published package version 0.1.1 checked before launch. Registry metadata did not declare a repository URL.

• maintainer or vendor documentation

  Official Excalidraw MCP is a separate app server from the cataloged Scofieldfree community server; this URL is recorded for identity disambiguation only.

Documentation checked 2026-10-28T00:00:00Z. Connection has not been runtime tested.