# Excalidraw MCP Integration

> Virtual collaborative whiteboard

## Overview

| Property | Value |
|----------|-------|
| Category | PIPEDREAM |
| Type | PIPEDREAM |
| Tools | 8 |
| URL | https://jelou.ai/es/marketplace/excalidraw |

## Available Tools (8)

### Create Collection

Creates a new collection (folder) in the Excalidraw Plus workspace for organizing scenes. Returns the new collection's ID — pass it to **Create Scene** or **Update Scene** to add scenes to this collection. [See the documentation](https://plus.excalidraw.com/docs/api/collections/post)

### Create Scene

Creates a new scene (whiteboard) in the Excalidraw Plus workspace. The API requires a collection — if no `collectionId` is provided, the scene is placed in the default (Main) collection automatically. Use **List Collections** to find the collection ID if the user wants the scene in a specific folder. Returns the new scene's ID and metadata. [See the documentation](https://plus.excalidraw.com/docs/api/scenes/post)

### Delete Scene

Permanently deletes an Excalidraw scene and all its drawing content. This action cannot be undone. Use **List Scenes** to find the scene ID before calling this tool. [See the documentation](https://plus.excalidraw.com/docs/api/scenes/sceneId-delete)

### Get Current User

Returns the current workspace context from Excalidraw Plus, including workspace ID, name, user IDs, and roles. Use this when the user asks 'who am I', 'what workspace am I in', or needs the workspace ID or user role. [See the documentation](https://plus.excalidraw.com/docs/api/workspace/workspaces-get)

### Get Scene

Returns metadata for a specific Excalidraw scene, and optionally its full drawing content (elements JSON). Use this when the user asks to view, inspect, or read a specific scene. Use **List Scenes** first to find the scene ID by name. Set `includeContent` to true only when the user explicitly asks for the drawing data — the content can be large. [See the documentation](https://plus.excalidraw.com/docs/api/scenes/sceneId-content-get)

### List Collections

Returns all collections (folders) in the Excalidraw Plus workspace. Use this to discover available collection IDs and names before filtering scenes by collection or creating a scene in a specific collection. Cross-reference: pass a collection ID from this result to **List Scenes** or **Create Scene**. [See the documentation](https://plus.excalidraw.com/docs/api/collections/get)

### List Scenes

Returns scenes (whiteboards) in the Excalidraw Plus workspace. Optionally filter by collection ID or apply a name substring filter (applied client-side, since the API has no server-side search). When the user says 'scenes in [collection]', use **List Collections** first to get the collection ID, then pass it as `collectionId` here. Use `nameFilter` (and `limit`) to narrow results when the user asks for a scene by name — the tool fetches up to `limit` scenes and returns only those whose name contains the filter string. [See the documentation](https://plus.excalidraw.com/docs/api/scenes/get)

### Update Scene

Updates an existing Excalidraw scene's name or collection membership. Use **List Scenes** to find the scene ID, and **List Collections** to find a collection ID if moving the scene. Only the fields you provide are updated — omitted fields remain unchanged. Note: the Excalidraw API does not support a description field on scenes. [See the documentation](https://plus.excalidraw.com/docs/api/scenes/sceneId-patch)

## Supported Channels

This integration works with:
- WhatsApp Business API
- Facebook Messenger
- Instagram Direct Messages
- Web Chat Widget

## AI Assistants Compatible

- ChatGPT (via MCP)
- Claude (via MCP)
- Gemini (via MCP)
- Custom AI Agents

## Quick Start

1. Sign up at https://apps.jelou.ai/signup
2. Navigate to Marketplace and add Excalidraw
3. Authenticate your Excalidraw account
4. Configure your messaging channels (WhatsApp, Facebook, etc.)
5. Copy the MCP server URL to your AI assistant

## Example Use Cases

- Automate customer inquiries using Excalidraw data
- Send notifications via WhatsApp when Excalidraw events occur
- Query Excalidraw data directly from ChatGPT or Claude
- Build AI agents that interact with Excalidraw

## Resources

- [All Integrations](https://jelou.ai/es/marketplace)
- [Full Documentation](https://jelou.ai/llms-full.txt)
- [API Docs](https://docs.jelou.ai)
- [Help Center](https://help.jelou.ai)