excalidraw.com
excalidraw.com logo

Excalidraw

Enables LLMs to create and manipulate Excalidraw diagrams through a Node.js API that provides tools for element creation...

Created byApr 22, 2025

Excalidraw MCP Server: Powerful Drawing API for LLM Integration

A comprehensive Model Context Protocol (MCP) server that enables seamless interaction with Excalidraw diagrams and drawings. This server provides LLMs (Large Language Models) with the ability to create, modify, query, and manipulate Excalidraw drawings through a structured, developer-friendly API.

Features

  • Full Excalidraw Element Control: Create, update, delete, and query any Excalidraw element
  • Advanced Element Manipulation: Group, align, distribute, lock, and unlock elements
  • Resource Management: Access and modify scene information, libraries, themes, and elements
  • Easy Integration: Works with Claude Desktop and other LLM platforms
  • Docker Support: Simple deployment with containerization options

API Tools Reference

Element Creation and Modification

  • create_element
  • update_element
  • delete_element
  • query_elements

Resource Management

  • get_resource

Element Organization

  • group_elements
  • ungroup_elements
  • align_elements
  • distribute_elements
  • lock_elements
  • unlock_elements

Integration with Claude Desktop

To use this server with the Claude Desktop application, add the following configuration to the "mcpServers" section of your claude_desktop_config.json:

Integration with Cursor

To use this server with Cursor, create a .cursor/mcp.json file in your workspace with the following configuration:
Make sure to:
  1. Replace /path/to/your/directory with the actual absolute path to your mcp_excalidraw installation
  1. Create the .cursor directory if it doesn't exist
  1. Ensure the path to index.js is correct and the file exists

Docker Integration

Installation Guide

NPM Installation

Docker Installation

Configuration Options

The server can be configured using the following environment variables:
  • LOG_LEVEL - Set the logging level (default: "info")
  • DEBUG - Enable debug mode (default: "false")
  • DEFAULT_THEME - Set the default theme (default: "light")

Usage Examples

Here are some practical examples of how to use the Excalidraw MCP server:

Creating a Rectangle Element

Querying Specific Elements

Grouping Multiple Elements

License

This Excalidraw MCP server is licensed under the MIT License. You are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Excalidraw MCP Server: Powerful Drawing API for LLM Integration

A comprehensive Model Context Protocol (MCP) server that enables seamless interaction with Excalidraw diagrams and drawings. This server provides LLMs (Large Language Models) with the ability to create, modify, query, and manipulate Excalidraw drawings through a structured, developer-friendly API.

Features

  • Full Excalidraw Element Control: Create, update, delete, and query any Excalidraw element
  • Advanced Element Manipulation: Group, align, distribute, lock, and unlock elements
  • Resource Management: Access and modify scene information, libraries, themes, and elements
  • Easy Integration: Works with Claude Desktop and other LLM platforms
  • Docker Support: Simple deployment with containerization options

API Tools Reference

Element Creation and Modification

  • create_element
  • update_element
  • delete_element
  • query_elements

Resource Management

  • get_resource

Element Organization

  • group_elements
  • ungroup_elements
  • align_elements
  • distribute_elements
  • lock_elements
  • unlock_elements

Integration with Claude Desktop

To use this server with the Claude Desktop application, add the following configuration to the "mcpServers" section of your claude_desktop_config.json:

Integration with Cursor

To use this server with Cursor, create a .cursor/mcp.json file in your workspace with the following configuration:
Make sure to:
  1. Replace /path/to/your/directory with the actual absolute path to your mcp_excalidraw installation
  1. Create the .cursor directory if it doesn't exist
  1. Ensure the path to index.js is correct and the file exists

Docker Integration

Installation Guide

NPM Installation

Docker Installation

Configuration Options

The server can be configured using the following environment variables:
  • LOG_LEVEL - Set the logging level (default: "info")
  • DEBUG - Enable debug mode (default: "false")
  • DEFAULT_THEME - Set the default theme (default: "light")

Usage Examples

Here are some practical examples of how to use the Excalidraw MCP server:

Creating a Rectangle Element

Querying Specific Elements

Grouping Multiple Elements

License

This Excalidraw MCP server is licensed under the MIT License. You are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.