MCP Excalidraw Server

https://github.com/yctimlin/mcp_excalidraw
Admin
A TypeScript-based system that integrates Excalidraw's drawing capabilities with Model Context...
Tokens:43,039
Snippets:531
Trust Score:6.8
License:MIT
Update:2 months ago
Show doc for...
Tokens:
Raw
### Install Skill Output Example

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

The JSON response returned upon a successful installation.

```json
{
  "success": true,
  "installed": true,
  "path": "~/.claude/skills/excalidraw-skill",
  "version": "2.0.0"
}
```

--------------------------------

### Install Skill Usage Examples

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Common patterns for installing the skill to default, project-level, or specific CLI target directories.

```bash
# Install to the default location for Claude Code
mcp-excalidraw-server install-skill

# Install to a project-level skill directory
mcp-excalidraw-server install-skill --dir ./skills

# Install for Codex CLI
mcp-excalidraw-server install-skill --target codex
```

--------------------------------

### Read Diagram Guide Example

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Usage example for calling the read_diagram_guide tool via the MCP client.

```typescript
const guide = await mcpClient.callTool('read_diagram_guide', {});
```

--------------------------------

### Get Resource Example

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Usage example for retrieving element data using the get_resource tool.

```typescript
await mcpClient.callTool('get_resource', { resource: 'elements' });
```

--------------------------------

### Installation Commands

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/README.md

Various installation commands based on the target environment or tool.

```bash
npx -y mcp-excalidraw-server install-skill --dir <skills-root>
```

```bash
npx -y mcp-excalidraw-server install-skill
```

```bash
npx -y mcp-excalidraw-server install-skill --target codex
```

--------------------------------

### start

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Starts the canvas server in the background on the default host and port.

```APIDOC
## start

### Description
Starts the canvas server in the background on the default host/port (127.0.0.1:3000).

### Usage
`mcp-excalidraw-server start`

### Environment Variables
- **HOST** (string) - Optional - Default: 127.0.0.1
- **PORT** (number) - Optional - Default: 3000
- **EXPRESS_SERVER_URL** (string) - Optional - Default: http://127.0.0.1:3000

### Output
JSON object containing server information and process PID.
```

--------------------------------

### Install Agent Skill

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Installs the bundled agent skill to a specified directory or default location. Use --print-source to output the source code instead of installing.

```bash
mcp-excalidraw-server install-skill [--dir <skills-root>] [--target claude|codex|<path>] [--print-source]
```

--------------------------------

### CLI Quick Start Commands

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/README.md

Common CLI operations for starting the server, drawing, and exporting diagrams.

```bash
# start the canvas (drawing commands auto-start it too) and open it
npx -y mcp-excalidraw-server start
open http://127.0.0.1:3000   # browser tab enables screenshots & mermaid

# draw something
echo '[
  {"id":"api","type":"rectangle","x":100,"y":100,"width":160,"height":80,"text":"API Server","backgroundColor":"#a5d8ff"},
  {"id":"db","type":"rectangle","x":400,"y":100,"width":160,"height":80,"text":"Database","backgroundColor":"#99e9f2"},
  {"type":"arrow","x":0,"y":0,"startElementId":"api","endElementId":"db","text":"SQL"}
]' | npx -y mcp-excalidraw-server add

# let your agent see its work
npx -y mcp-excalidraw-server describe
npx -y mcp-excalidraw-server screenshot --out diagram.png

# diagrams as repo artifacts
mkdir -p docs
npx -y mcp-excalidraw-server export --out docs/architecture.excalidraw

# or straight into an Obsidian vault (.md extension → Obsidian Excalidraw plugin format)
npx -y mcp-excalidraw-server export --out ~/vault/diagrams/architecture.excalidraw.md
```

--------------------------------

### Version Output Example

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

The standard output format for the version command.

```text
2.0.0
```

--------------------------------

### Import scene examples

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Examples of calling the import_scene tool using file paths or raw data.

```typescript
await mcpClient.callTool('import_scene', {
  filePath: 'docs/architecture.excalidraw',
  mode: 'merge'
});
```

```typescript
await mcpClient.callTool('import_scene', {
  data: '[{"type":"rectangle",...}]',
  mode: 'replace'
});
```

--------------------------------

### Export scene examples

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Examples of calling the export_scene tool for different file formats.

```typescript
await mcpClient.callTool('export_scene', {
  filePath: 'docs/architecture.excalidraw'
});
```

```typescript
await mcpClient.callTool('export_scene', {
  filePath: '~/vault/diagrams/architecture.excalidraw.md'
});
```

--------------------------------

### create_element usage examples

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Examples demonstrating how to create a rectangle and an arrow using the create_element tool.

```typescript
await mcpClient.callTool('create_element', {
  type: 'rectangle',
  x: 100,
  y: 100,
  width: 200,
  height: 80,
  text: 'API Server',
  backgroundColor: '#a5d8ff'
});
```

```typescript
await mcpClient.callTool('create_element', {
  type: 'arrow',
  x: 0,
  y: 0,
  startElementId: 'rect1',
  endElementId: 'rect2',
  text: 'uses',
  endArrowhead: 'arrow'
});
```

--------------------------------

### Describe Scene Usage Example

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Demonstrates calling the describe_scene tool.

```typescript
const description = await mcpClient.callTool('describe_scene', {});
```

--------------------------------

### Start Canvas Server with Host and Port

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/configuration.md

Starts the Express.js and Excalidraw canvas server using specific host and port variables.

```bash
HOST=127.0.0.1 PORT=3000 npm run canvas
```

--------------------------------

### Agent Installation Instructions

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/README.md

Instructions for setting up the Excalidraw canvas toolkit within a coding agent environment.

```text
Install the Excalidraw canvas toolkit so you can draw diagrams for me:

1. Choose the right skill directory for this agent and scope (project or global).
2. Run: npx -y mcp-excalidraw-server install-skill --dir <that-skills-directory>
3. Read the installed excalidraw-skill/SKILL.md so you know the drawing workflow.
4. Start the canvas with: npx -y mcp-excalidraw-server start
   then tell me to open http://127.0.0.1:3000 in my browser (screenshots need an open tab).
5. Draw a small test diagram — two labeled boxes connected by an arrow — take a
   screenshot, and show me the result to confirm everything works.
```

--------------------------------

### Start the canvas server

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Starts the canvas server in the background. Use environment variables to override default host and port settings.

```bash
mcp-excalidraw-server start
```

```bash
PORT=4000 npx -y mcp-excalidraw-server start
```

--------------------------------

### query_elements usage examples

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Examples for querying elements by type/property filters and by bounding box.

```typescript
await mcpClient.callTool('query_elements', {
  type: 'rectangle',
  filter: { locked: true }
});
```

```typescript
await mcpClient.callTool('query_elements', {
  bbox: { x_min: 0, x_max: 500, y_min: 0, y_max: 500 }
});
```

--------------------------------

### Get Canvas Screenshot Usage Example

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Demonstrates calling the get_canvas_screenshot tool.

```typescript
const screenshot = await mcpClient.callTool('get_canvas_screenshot', {});
```

--------------------------------

### get_element usage example

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Example call to retrieve an element by its ID.

```typescript
const result = await mcpClient.callTool('get_element', { id: 'rect1' });
```

--------------------------------

### install-skill

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Installs the bundled agent skill into a specified project or global skill directory.

```APIDOC
## install-skill

### Description
Installs the bundled agent skill into a project or global skill directory.

### Command
`mcp-excalidraw-server install-skill [--dir <skills-root>] [--target claude|codex|<path>] [--print-source]`

### Options
- **--dir** (string) - Optional - Target skill root directory (defaults to ~/.claude/skills)
- **--target** (string) - Optional - Shorthand for --dir (claude -> ~/.claude/skills, codex -> ~/.codex/skills)
- **--print-source** (boolean) - Optional - Print the full bundled skill source to stdout instead of installing

### Response
- **success** (boolean) - Indicates if the operation was successful
- **installed** (boolean) - Indicates if the skill was installed
- **path** (string) - The installation path
- **version** (string) - The version of the installed skill
```

--------------------------------

### Run Docker Canvas Server

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/README.md

Command to start the Excalidraw canvas server using Docker.

```bash
docker run -d -p 3000:3000 --name mcp-excalidraw-canvas ghcr.io/yctimlin/mcp_excalidraw-canvas:latest
```

--------------------------------

### Configure EXCALIDRAW_NO_AUTOSTART

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/configuration.md

Controls whether the canvas server starts automatically. Setting to '1' requires manual server management.

```bash
export EXCALIDRAW_NO_AUTOSTART=1
```

```bash
# Disable autostart (fail if server isn't running)
export EXCALIDRAW_NO_AUTOSTART=1
mcp-excalidraw-server status  # Will fail with exit code 3 if server is offline

# Enable autostart (default)
unset EXCALIDRAW_NO_AUTOSTART
mcp-excalidraw-server status  # Will start the server automatically
```

--------------------------------

### Arrange command examples

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Common usage patterns for aligning, distributing, grouping, locking, and duplicating elements.

```bash
# Align 3 boxes to the left
mcp-excalidraw-server arrange align --ids rect1,rect2,rect3 --to left

# Distribute horizontally
mcp-excalidraw-server arrange distribute --ids a,b,c,d,e --to horizontal

# Group shapes
mcp-excalidraw-server arrange group --ids box1,box2,arrow1

# Lock the layout
mcp-excalidraw-server arrange lock --ids box1,box2

# Duplicate with offset
mcp-excalidraw-server arrange duplicate --ids myBox --offsetX 50 --offsetY 50
```

--------------------------------

### Call export_to_image tool

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Examples of calling the export_to_image tool with different configurations.

```typescript
await mcpClient.callTool('export_to_image', {
  format: 'png',
  filePath: 'diagrams/architecture.png'
});
```

```typescript
await mcpClient.callTool('export_to_image', {
  format: 'svg',
  filePath: 'diagrams/flow.svg',
  background: false
});
```

--------------------------------

### Example return structure for batch_create_elements

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

JSON structure returned by the tool upon successful execution.

```json
{
  "content": [
    {
      "type": "text",
      "text": "X elements created successfully!\n\n[...elements...]\n\n✅ Synced to canvas"
    }
  ]
}
```

--------------------------------

### Usage examples for set_viewport

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Various ways to invoke the set_viewport tool using the MCP client.

```typescript
await mcpClient.callTool('set_viewport', {
  scrollToContent: true,
  viewportZoomFactor: 0.85
});
```

```typescript
await mcpClient.callTool('set_viewport', {
  scrollToElementIds: ['rect1', 'rect2', 'rect3'],
  viewportZoomFactor: 0.9
});
```

```typescript
await mcpClient.callTool('set_viewport', {
  scrollToElementId: 'main-box'
});
```

```typescript
await mcpClient.callTool('set_viewport', {
  zoom: 1.5,
  offsetX: 100,
  offsetY: 200
});
```

--------------------------------

### Install Portable Agent Skill

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/README.md

Copies the portable agent skill into a specified directory, replacing any existing versions.

```bash
npx -y mcp-excalidraw-server install-skill --dir <skills-root>
```

--------------------------------

### Agent Playbook Commands

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/README.md

Commands for installing and inspecting the skill source within an agent.

```bash
npx -y mcp-excalidraw-server install-skill --dir <skills-root>
npx -y mcp-excalidraw-server install-skill --print-source  # inspect bundled source path
```

--------------------------------

### Call export_to_excalidraw_url tool

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Example usage of the mcpClient to invoke the export_to_excalidraw_url tool.

```typescript
const result = await mcpClient.callTool('export_to_excalidraw_url', {});
// Returns: { url: "https://excalidraw.com/#json=..." }
```

--------------------------------

### Unlock Elements Usage Example

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Example call to unlock a specific element.

```typescript
await mcpClient.callTool('unlock_elements', { elementIds: ['rect1'] });
```

--------------------------------

### Lock Elements Usage Example

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Example call to lock specific elements.

```typescript
await mcpClient.callTool('lock_elements', {
  elementIds: ['background', 'title']
});
```

--------------------------------

### Create architecture diagram with batch_create_elements

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Usage example demonstrating how to create multiple rectangles and a connecting arrow in a single MCP tool call.

```typescript
await mcpClient.callTool('batch_create_elements', {
  elements: [
    { id: 'api', type: 'rectangle', x: 100, y: 100, width: 160, height: 80, text: 'API' },
    { id: 'db', type: 'rectangle', x: 400, y: 100, width: 160, height: 80, text: 'Database' },
    { type: 'arrow', x: 0, y: 0, startElementId: 'api', endElementId: 'db', text: 'SQL' }
  ]
});
```

--------------------------------

### Distribute Elements Usage Example

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Example call to distribute five elements horizontally.

```typescript
await mcpClient.callTool('distribute_elements', {
  elementIds: ['a', 'b', 'c', 'd', 'e'],
  direction: 'horizontal'
});
```

--------------------------------

### Group Elements Usage Example

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Example call to group three specific elements.

```typescript
await mcpClient.callTool('group_elements', {
  elementIds: ['rect1', 'rect2', 'arrow1']
});
```

--------------------------------

### Call create_from_mermaid tool

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Example of calling the create_from_mermaid tool with a flowchart diagram.

```typescript
await mcpClient.callTool('create_from_mermaid', {
  mermaidDiagram: `
    graph TD;
    A[Input] --> B{Process};
    B -->|Yes| C[Output];
    B -->|No| D[Error];
  `
});
```

--------------------------------

### Disable Autostart

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Prevent the canvas server from starting automatically when running commands.

```bash
EXCALIDRAW_NO_AUTOSTART=1 mcp-excalidraw-server query
```

--------------------------------

### Align Elements Usage Example

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Example call to align three specific elements to the left.

```typescript
await mcpClient.callTool('align_elements', {
  elementIds: ['rect1', 'rect2', 'rect3'],
  alignment: 'left'
});
```

--------------------------------

### read_diagram_guide

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Retrieves a comprehensive design guide for creating professional Excalidraw diagrams, covering color palettes, sizing, and layout patterns.

```APIDOC
## read_diagram_guide

### Description
Returns a comprehensive design guide for creating professional Excalidraw diagrams: color palette, sizing rules, layout patterns, arrow binding best practices, templates, and anti-patterns.

### Parameters
None.

### Example
```typescript
const guide = await mcpClient.callTool('read_diagram_guide', {});
```
```

--------------------------------

### Initialize MCP stdio server in index.ts

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/architecture.md

Starts the MCP server using the stdio transport and handles optional canvas auto-start logic.

```typescript
async function runServer(): Promise<StdioServerHandle> {
  const handle = serveStdio(excalidrawMcpServerFactory, {
    onerror: error => { logger.warn('MCP error:', error.message); }
  });
  
  if (ENABLE_CANVAS_SYNC && !EXCALIDRAW_NO_AUTOSTART) {
    void ensureCanvasReadyForMcpTool().catch(...);
  }
  
  process.stdin.resume();
  return handle;
}
```

--------------------------------

### Get Resource Return Format

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

The expected JSON structure for the response from the get_resource tool.

```json
{
  "content": [
    {
      "type": "text",
      "text": "{resource data}"
    }
  ]
}
```

--------------------------------

### Duplicate Elements Usage Example

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Demonstrates calling the duplicate_elements tool with specific element IDs and offsets.

```typescript
await mcpClient.callTool('duplicate_elements', {
  elementIds: ['rect1', 'rect2', 'arrow1'],
  offsetX: 50,
  offsetY: 50
});
```

--------------------------------

### Display Help Information

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Access general help or command-specific documentation using various flags.

```bash
mcp-excalidraw-server help                 # General help
mcp-excalidraw-server help <command>       # Help for <command>
mcp-excalidraw-server --help               # Same as help
mcp-excalidraw-server -h                   # Same as help
```

--------------------------------

### Run from Source

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/README.md

Commands to build and execute the canvas server and MCP server from source.

```bash
npm ci
npm run build
PORT=3000 npm run canvas          # canvas server (terminal 1)
node dist/index.js                # MCP server over stdio (terminal 2, usually launched by your MCP client)
node dist/bin.js status           # or drive the CLI straight from the build
```

--------------------------------

### Ungroup Elements Usage Example

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Example call to ungroup elements from a specific group.

```typescript
await mcpClient.callTool('ungroup_elements', { groupId: 'group-abc' });
```

--------------------------------

### Configure Global Options

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Set the canvas URL for server communication.

```bash
mcp-excalidraw-server --url http://localhost:4000 status
mcp-excalidraw-server --url=http://localhost:4000 add ...
```

--------------------------------

### get

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Fetch a single element by its unique ID.

```APIDOC
## get

### Description
Fetch a single element by ID.

### Usage
`mcp-excalidraw-server get <id>`

### Parameters
- **id** (string) - Required - The unique identifier of the element

### Response
- **id** (string) - Element ID
- **type** (string) - Element type
```

--------------------------------

### Run development and CLI commands

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/README.md

Use these npm scripts to verify types, build the project, interact with the CLI, and sync local skill definitions.

```bash
npm run type-check
npm run build
npm run cli -- status      # run the CLI from the local build
npm run sync:skills        # after editing skills/excalidraw-skill, sync the repo-local agent copy
```

--------------------------------

### Project File Structure Summary

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/README.md

Displays the directory layout of the generated documentation workspace.

```text
/workspace/home/output/
├── README.md                      ← You are here
├── mcp-tools-reference.md         ← All 26 MCP tools
├── types.md                       ← All type definitions
├── cli-reference.md               ← All CLI commands
├── configuration.md               ← Environment variables
├── core-modules.md               ← Internal modules
└── architecture.md               ← System design & flows
```

--------------------------------

### Get Excalidraw element

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Fetch a single element by its unique ID.

```bash
mcp-excalidraw-server get <id>
```

```json
{
  "id": "...",
  "type": "rectangle",
  ...
}
```

```bash
mcp-excalidraw-server get rect1
```

--------------------------------

### Display Version Information

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Retrieve the current package version using flags or the version command.

```bash
mcp-excalidraw-server --version
mcp-excalidraw-server -v
mcp-excalidraw-server version
```

--------------------------------

### Configure Claude Desktop for MCP

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/configuration.md

Add the server to the Claude Desktop configuration file located at ~/.config/Claude/claude_desktop_config.json.

```json
{
  "mcpServers": {
    "excalidraw": {
      "command": "npx",
      "args": ["-y", "mcp-excalidraw-server"],
      "env": {
        "EXPRESS_SERVER_URL": "http://127.0.0.1:3000",
        "ENABLE_CANVAS_SYNC": "true"
      }
    }
  }
}
```

--------------------------------

### Read Diagram Guide Tool Definition

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

The TypeScript function signature for the read_diagram_guide tool.

```typescript
async function read_diagram_guide(args: {}): Promise<CallToolResult>
```

--------------------------------

### Create multiple elements via CLI

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/README.md

Use the add command to pipe a JSON array of element definitions into the server.

```bash
echo '[{"type":"rectangle",...}, ...]' | mcp-excalidraw-server add
```

--------------------------------

### import

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Imports elements from a .excalidraw JSON file, Obsidian .excalidraw.md file, or raw JSON data.

```APIDOC
## import

### Description
Import elements from a .excalidraw JSON file, Obsidian .excalidraw.md file, or raw JSON data.

### Options
- `--replace`: Clear the canvas first (default: merge with existing elements)

### Input
- File path to .excalidraw or .excalidraw.md
- `-` or no argument: read from stdin
```

--------------------------------

### Export diagram to file

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/README.md

Export the current scene to a file using the CLI.

```bash
mcp-excalidraw-server export --out file.excalidraw
```

--------------------------------

### Run CLI smoke tests

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/README.md

Executes basic server lifecycle and element addition commands via the CLI.

```bash
npx -y mcp-excalidraw-server start
npx -y mcp-excalidraw-server status
npx -y mcp-excalidraw-server add --one '{"type":"rectangle","x":100,"y":100,"width":300,"height":200}'
npx -y mcp-excalidraw-server describe
```

--------------------------------

### help

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Displays general help or help for a specific command.

```APIDOC
## help

### Description
Displays general help or help for a specific command.

### Command
`mcp-excalidraw-server help [command]`
`mcp-excalidraw-server --help`
`mcp-excalidraw-server -h`
```

--------------------------------

### Environment Variable Configurations

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/configuration.md

Environment file templates for development, Docker, CI/CD, and secure export directory configurations.

```bash
# .env.dev
EXPRESS_SERVER_URL=http://127.0.0.1:3000
ENABLE_CANVAS_SYNC=true
HOST=127.0.0.1
PORT=3000
```

```bash
# .env.docker
EXPRESS_SERVER_URL=http://host.docker.internal:3000
ENABLE_CANVAS_SYNC=true
EXCALIDRAW_NO_AUTOSTART=1
```

```bash
# .env.ci
EXPRESS_SERVER_URL=http://localhost:3000
ENABLE_CANVAS_SYNC=false
EXCALIDRAW_NO_AUTOSTART=1
```

```bash
# .env.secure
EXCALIDRAW_EXPORT_DIR=/home/user/diagrams
```

--------------------------------

### Delete Excalidraw element

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Defines the function signature for deleting an element by ID and provides a usage example.

```typescript
async function delete_element(args: {
  id: string;
}): Promise<CallToolResult>
```

```json
{
  "content": [
    {
      "type": "text",
      "text": "Element [id] deleted successfully"
    }
  ]
}
```

```typescript
await mcpClient.callTool('delete_element', { id: 'rect1' });
```

--------------------------------

### importScene

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/core-modules.md

Imports elements from a .excalidraw file, Obsidian .excalidraw.md, or raw JSON string.

```APIDOC
## importScene

### Description
Import elements from a .excalidraw file, Obsidian .excalidraw.md, or raw JSON.

### Parameters
- **filePath** (string) - Optional - Path to .excalidraw or .excalidraw.md file
- **data** (string) - Optional - Raw JSON string
- **mode** ('replace' | 'merge') - Required - Clear canvas first or merge with existing

### Returns
- **count** (number) - Number of elements imported
- **fileCount** (number) - Number of files imported
- **mode** ('replace' | 'merge') - The mode used for the operation
```

--------------------------------

### Get Canvas Screenshot Tool Definition

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Defines the function signature for capturing a screenshot of the current canvas.

```typescript
async function get_canvas_screenshot(args: {
  background?: boolean;
}): Promise<CallToolResult>
```

--------------------------------

### buildSceneFile

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/core-modules.md

Builds a complete .excalidraw JSON scene from the current canvas.

```APIDOC
## buildSceneFile

### Description
Build a complete .excalidraw JSON scene from the current canvas.

### Signature
`async function buildSceneFile(): Promise<{ scene: Record<string, any>; elementCount: number; }>`

### Returns
- **scene** (Record<string, any>) - Full Excalidraw scene object (type, version, elements, files, appState)
- **elementCount** (number) - Number of elements in the scene
```

--------------------------------

### Export and Import Obsidian-Compatible Diagrams

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/skills/excalidraw-skill/SKILL.md

Commands to export diagrams in the native Obsidian .excalidraw.md format and import them back into the server.

```bash
npx -y mcp-excalidraw-server export --out "$VAULT/diagrams/system-map.excalidraw.md"   # .md → Obsidian format (or force with --format obsidian)
npx -y mcp-excalidraw-server import "$VAULT/diagrams/system-map.excalidraw.md" --replace  # reads both plain and compressed Drawing blocks
```

--------------------------------

### OpenCode Configuration

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/README.md

Configuration for OpenCode using a local npx command.

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "excalidraw": {
      "type": "local",
      "command": ["npx", "-y", "mcp-excalidraw-server"],
      "enabled": true
    }
  }
}
```

--------------------------------

### Get Resource Tool Definition

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

The TypeScript function signature for the get_resource tool, which accepts specific resource types.

```typescript
async function get_resource(args: {
  resource: 'scene' | 'library' | 'theme' | 'elements';
}): Promise<CallToolResult>
```

--------------------------------

### Get Canvas Screenshot Return Format

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

The expected JSON response structure containing base64-encoded image data.

```json
{
  "content": [
    {
      "type": "image",
      "data": "base64-encoded-png-data",
      "mimeType": "image/png"
    }
  ]
}
```

--------------------------------

### Create Diagrams via Pipe

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Pipe JSON element definitions directly into the add command.

```bash
echo '[
  {"id":"api","type":"rectangle","x":100,"y":100,"width":160,"height":80,"text":"API Server","backgroundColor":"#a5d8ff"},
  {"id":"db","type":"rectangle","x":400,"y":100,"width":160,"height":80,"text":"Database","backgroundColor":"#99e9f2"},
  {"type":"arrow","x":0,"y":0,"startElementId":"api","endElementId":"db","text":"SQL"}
]' | mcp-excalidraw-server add
```

--------------------------------

### Configure Docker for MCP

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/configuration.md

Run the MCP server container with the necessary environment variables for canvas synchronization.

```json
{
  "command": "docker",
  "args": [
    "run", "-i", "--rm",
    "-e", "EXPRESS_SERVER_URL=http://host.docker.internal:3000",
    "-e", "ENABLE_CANVAS_SYNC=true",
    "ghcr.io/yctimlin/mcp_excalidraw:latest"
  ]
}
```

--------------------------------

### Claude Desktop MCP Configuration

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/README.md

Configuration for Claude Desktop using npx, local node, or Docker.

```json
{
  "mcpServers": {
    "excalidraw": {
      "command": "npx",
      "args": ["-y", "mcp-excalidraw-server"]
    }
  }
}
```

```json
{
  "mcpServers": {
    "excalidraw": {
      "command": "node",
      "args": ["/absolute/path/to/mcp_excalidraw/dist/index.js"],
      "env": {
        "EXPRESS_SERVER_URL": "http://127.0.0.1:3000",
        "ENABLE_CANVAS_SYNC": "true"
      }
    }
  }
}
```

```json
{
  "mcpServers": {
    "excalidraw": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "EXPRESS_SERVER_URL=http://host.docker.internal:3000",
        "-e", "ENABLE_CANVAS_SYNC=true",
        "ghcr.io/yctimlin/mcp_excalidraw:latest"
      ]
    }
  }
}
```

--------------------------------

### apply

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Apply a multi-operation patch containing create, update, and delete actions.

```APIDOC
## apply

### Description
Apply a multi-operation patch in one call: create, update, delete.

### Usage
`mcp-excalidraw-server apply <patch.json>`

### Input Format
- **create** (array) - Optional - List of elements to create
- **update** (array) - Optional - List of update operations
- **delete** (array) - Optional - List of IDs to delete

### Response
- **success** (boolean) - Operation status
- **created** (number) - Count of created elements
- **updated** (number) - Count of updated elements
- **deleted** (number) - Count of deleted elements
```

--------------------------------

### Update Excalidraw element properties

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Defines the function signature for updating element properties and provides a usage example for moving an element and changing its color.

```typescript
async function update_element(args: {
  id: string;
  type?: ExcalidrawElementType;
  x?: number;
  y?: number;
  width?: number;
  height?: number;
  backgroundColor?: string;
  strokeColor?: string;
  strokeWidth?: number;
  strokeStyle?: string;
  roughness?: number;
  opacity?: number;
  text?: string;
  fontSize?: number;
  fontFamily?: string | number;
}): Promise<CallToolResult>
```

```json
{
  "content": [
    {
      "type": "text",
      "text": "Element updated successfully!\n\n{element JSON}\n\n✅ Synced to canvas"
    }
  ]
}
```

```typescript
await mcpClient.callTool('update_element', {
  id: 'rect1',
  x: 200,
  y: 150,
  backgroundColor: '#ffc9c9'
});
```

--------------------------------

### Import tool return format

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Expected JSON structure returned by the import_scene tool.

```json
{
  "content": [
    {
      "type": "text",
      "text": "Scene imported successfully:\n- Elements: X\n- Files: Y\n- Mode: [replace/merge]"
    }
  ]
}
```

--------------------------------

### Configure HOST

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/configuration.md

Sets the network interface for the canvas Express server.

```bash
export HOST=0.0.0.0
```

```bash
# Local only (default)
HOST=127.0.0.1 npm run canvas

# All interfaces (expose on network)
HOST=0.0.0.0 npm run canvas

# Specific hostname
HOST=canvas.example.com npm run canvas
```

--------------------------------

### CLI Command Reference

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/README.md

Overview of available commands for the mcp-excalidraw CLI tool.

```APIDOC
## CLI Commands

### Description
Commands are executed via `npx -y mcp-excalidraw-server <command>` or `excalidraw-canvas <command>`.

### Commands
- **start / stop / status**: Manage the canvas server.
- **add [file|-]**: Batch-create elements from a JSON array.
- **apply [file|-]**: Perform multi-op patches (create, update, delete).
- **get <id>**: Read an element by ID.
- **delete <id...>**: Remove elements by ID.
- **update <id> --set '{...}'**: Update an element's properties.
- **query**: Filter elements by type, bounding box, or key-value pairs.
- **describe**: Get an AI-readable scene summary.
- **screenshot**: Capture the canvas as PNG or SVG.
- **export [--out f.excalidraw] [--format json|obsidian]**: Export the scene to a file.
- **import [file|-] [--replace]**: Import a scene file.
- **mermaid [file|-]**: Convert Mermaid syntax to canvas elements.
- **snapshot save|list|restore <name>**: Manage named snapshots.
- **arrange align|distribute|group|ungroup|lock|unlock|duplicate**: Perform layout operations.
- **share**: Upload to excalidraw.com for a shareable URL.
- **clear --yes**: Wipe the canvas.
- **install-skill [--dir <skills-root>]**: Install the portable agent skill.
```

--------------------------------

### import_scene

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Imports elements from a .excalidraw JSON file, Obsidian .excalidraw.md file, or raw JSON data.

```APIDOC
## import_scene

### Description
Import elements from a .excalidraw JSON file, Obsidian .excalidraw.md file, or raw JSON data.

### Parameters
- **filePath** (string) - Optional - Path to a .excalidraw or .excalidraw.md file
- **data** (string) - Optional - Raw .excalidraw JSON string (alternative to filePath)
- **mode** (string) - Required - 'replace' to clear canvas first, 'merge' to append to existing elements

### Request Example
await mcpClient.callTool('import_scene', {
  filePath: 'docs/architecture.excalidraw',
  mode: 'merge'
});

### Response
- **content** (array) - Contains the text result confirming successful import, element count, and mode used.
```

--------------------------------

### ensureCanvasReadyForMcpTool

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/core-modules.md

Ensures the canvas server is running before executing a tool. It spawns the server on the first call and returns the existing promise for subsequent calls.

```APIDOC
## ensureCanvasReadyForMcpTool

### Description
Ensures the canvas server is running before calling a canvas-dependent tool. It is idempotent and handles concurrent calls by awaiting the same initialization promise.

### Signature
`async function ensureCanvasReadyForMcpTool(): Promise<void>`

### Behavior
- First call: spawns canvas server, awaits connection, and sets the internal state.
- Subsequent calls: await the existing initialization promise.

### Errors
- Throws an Error if the server spawn fails or if the server fails to become ready.
```

--------------------------------

### Return format for create_from_mermaid

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Expected JSON response structure for the create_from_mermaid tool.

```json
{
  "content": [
    {
      "type": "text",
      "text": "Mermaid diagram converted:\n- Elements: X\n[Element list]"
    }
  ]
}
```

--------------------------------

### Execute CLI Commands

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/skills/excalidraw-skill/SKILL.md

Run canvas operations via the command line. The server auto-starts on the first command execution.

```bash
npx -y mcp-excalidraw-server <command>
```

--------------------------------

### Antigravity MCP Configuration

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/README.md

Configuration for Google Antigravity using npx.

```json
{
  "mcpServers": {
    "excalidraw": {
      "command": "npx",
      "args": ["-y", "mcp-excalidraw-server"]
    }
  }
}
```

--------------------------------

### Ensure canvas readiness for MCP tools

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/core-modules.md

Spawns the canvas server and awaits connection, ensuring idempotency for concurrent callers.

```typescript
async function ensureCanvasReadyForMcpTool(): Promise<void>
```

--------------------------------

### set_viewport return format

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

The expected JSON response structure upon successful execution.

```json
{
  "content": [
    {
      "type": "text",
      "text": "Viewport set successfully"
    }
  ]
}
```

--------------------------------

### File I/O & Export Tools

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/skills/excalidraw-skill/references/cheatsheet.md

Tools for importing, exporting, and sharing scenes.

```APIDOC
## Tool: export_scene
### Description
Export the current scene to an .excalidraw JSON file.
### Parameters
- **filePath** (string) - Optional

## Tool: import_scene
### Description
Import a scene from a file or raw data.
### Parameters
- **mode** (string) - Required ("replace"|"merge")
- **filePath** (string) - Optional
- **data** (string) - Optional

## Tool: export_to_image
### Description
Export the canvas to PNG or SVG.
### Parameters
- **format** (string) - Required ("png"|"svg")
- **filePath** (string) - Optional
- **background** (boolean) - Optional

## Tool: export_to_excalidraw_url
### Description
Upload the scene and return a shareable URL.
```

--------------------------------

### CI/CD Integration

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Automated verification of diagram versions and element counts.

```bash
# Check if a diagram matches an expected version
mcp-excalidraw-server import --replace docs/architecture.excalidraw
mcp-excalidraw-server export | diff - expected.excalidraw.json

# Or just verify element count
mcp-excalidraw-server query --type rectangle | jq '.count'
```

--------------------------------

### Manage canvas snapshots

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Saves, lists, or restores named canvas states. Requires the server to be running.

```bash
mcp-excalidraw-server snapshot save <name>         # Save current state
mcp-excalidraw-server snapshot list                # List all snapshots
mcp-excalidraw-server snapshot restore <name>     # Restore a snapshot
```

```json
{
  "success": true,
  "name": "v1.0",
  "elementCount": 5
}
```

```json
{
  "success": true,
  "snapshots": [
    {"name": "v1.0", "elementCount": 5, "createdAt": "2026-01-15T..."}
  ]
}
```

```json
{
  "success": true,
  "name": "v1.0",
  "elementCount": 5
}
```

```bash
# Save a checkpoint
mcp-excalidraw-server snapshot save baseline

# See all checkpoints
mcp-excalidraw-server snapshot list

# Go back to baseline
mcp-excalidraw-server snapshot restore baseline
```

--------------------------------

### version

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Displays the package version.

```APIDOC
## version

### Description
Displays the current package version.

### Command
`mcp-excalidraw-server --version`
`mcp-excalidraw-server -v`
`mcp-excalidraw-server version`
```

--------------------------------

### Ensure Canvas Server is Running

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/core-modules.md

Verifies server responsiveness and spawns the process if necessary, waiting for the health endpoint to signal readiness.

```typescript
async function ensureCanvasRunning(): Promise<void>
```

--------------------------------

### Cursor MCP Configuration

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/README.md

Configuration for Cursor editor using npx or Docker.

```json
{
  "mcpServers": {
    "excalidraw": {
      "command": "npx",
      "args": ["-y", "mcp-excalidraw-server"]
    }
  }
}
```

```json
{
  "mcpServers": {
    "excalidraw": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "EXPRESS_SERVER_URL=http://host.docker.internal:3000",
        "-e", "ENABLE_CANVAS_SYNC=true",
        "ghcr.io/yctimlin/mcp_excalidraw:latest"
      ]
    }
  }
}
```

--------------------------------

### Return format for export_to_excalidraw_url

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

The expected JSON response format when calling the export_to_excalidraw_url tool.

```json
{
  "content": [
    {
      "type": "text",
      "text": "Scene exported to shareable URL:\nhttps://excalidraw.com/#json=...&theme=light"
    }
  ]
}
```

--------------------------------

### Run local bind regression test

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/README.md

Executes the local bind test suite.

```bash
npm run test:bind
```

--------------------------------

### Iterative Refinement Workflow

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/skills/excalidraw-skill/SKILL.md

A conceptual feedback loop demonstrating the process of adding elements, verifying via screenshots, and updating properties to resolve layout issues.

```text
add elements
  → screenshot → view → "text truncated on auth-svc"
  → update auth-svc --set '{"width": 220}' → screenshot → "overlap between auth-svc and rate-limiter"
  → update rate-limiter --set '{"x": 520}' → screenshot → "all checks pass"
  → proceed
```

--------------------------------

### Capture frontend screenshots

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/README.md

Automates UI checks using agent-browser to open the canvas and capture a screenshot.

```bash
agent-browser install
agent-browser open http://127.0.0.1:3000
agent-browser wait --load networkidle
agent-browser screenshot /tmp/canvas.png
```

--------------------------------

### Arrange elements via CLI

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Perform layout operations like alignment, distribution, grouping, and duplication on specified element IDs.

```bash
mcp-excalidraw-server arrange <operation> --ids <id>,<id>,... [--to <direction>]
```

--------------------------------

### Build Scene File

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/core-modules.md

Generates a complete .excalidraw JSON object from the current canvas, including metadata and file references.

```typescript
async function buildSceneFile(): Promise<{
  scene: Record<string, any>;
  elementCount: number;
}>
```

--------------------------------

### add

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Create multiple elements from a JSON array or a single element using the --one flag.

```APIDOC
## add

### Description
Create multiple elements from a JSON array (file, stdin, or inline).

### Usage
`mcp-excalidraw-server add [elements.json]`
`mcp-excalidraw-server add --one '<json>'`

### Options
- **--one** (string) - Optional - Create a single element without wrapping in an array

### Response
- **success** (boolean) - Operation status
- **count** (number) - Number of elements created
- **elements** (array) - List of created elements
```

--------------------------------

### Run MCP stdio wire test

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/README.md

Validates protocol compliance by driving the server with raw JSON-RPC frames.

```bash
npm run test:mcp
```

--------------------------------

### Return format for export_to_image

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Expected JSON response structure for the export_to_image tool.

```json
{
  "content": [
    {
      "type": "text",
      "text": "Image exported to [filePath]"
    }
  ]
}
```

--------------------------------

### Add MCP Server via Claude Code CLI

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/configuration.md

Use the Claude Code CLI command to register the MCP server for the current user.

```bash
claude mcp add excalidraw --scope user -- npx -y mcp-excalidraw-server
```

--------------------------------

### Align elements via CLI

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/README.md

Align multiple elements by providing their IDs and the target direction.

```bash
mcp-excalidraw-server arrange align --ids id1,id2,id3 --to left
```

--------------------------------

### Project Directory Structure

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/00-START-HERE.md

Visual representation of the source code organization and module layout.

```text
mcp-excalidraw-server/
├── src/
│   ├── bin.ts                    # MCP/CLI router
│   ├── index.ts                  # MCP server entry
│   ├── server.ts                 # Canvas server entry
│   ├── types.ts                  # Type definitions
│   ├── cli/                      # CLI commands
│   ├── core/                     # Core logic (15+ modules)
│   └── utils/                    # Logger
├── dist/                         # Compiled output
├── skills/                       # Agent skill
├── package.json
└── README.md                     # Project README
```

--------------------------------

### Import Canvas Elements

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/cli-reference.md

Imports elements from a file or stdin into the current canvas, with options to merge or replace existing content.

```bash
mcp-excalidraw-server import [--replace] [file.excalidraw|file.excalidraw.md|-]
echo '[...]' | mcp-excalidraw-server import -
```

```bash
# Merge into existing canvas
mcp-excalidraw-server import docs/architecture.excalidraw

# Replace the entire canvas
mcp-excalidraw-server import --replace docs/architecture.excalidraw

# Import from stdin, merging
cat docs/architecture.excalidraw | mcp-excalidraw-server import -

# Import from stdin, replacing
echo '[...]' | mcp-excalidraw-server import --replace -
```

--------------------------------

### Export tool return format

Source: https://github.com/yctimlin/mcp_excalidraw/blob/main/_autodocs/mcp-tools-reference.md

Expected JSON structure returned by the export_scene tool.

```json
{
  "content": [
    {
      "type": "text",
      "text": "Scene exported:\n- Elements: X\n- File: [path]\n[Scene JSON preview]"
    }
  ]
}
```
Tokens:
Raw