excalidraw-mcp-server

Instructions

Implementation Reference

• src/mcp/tools/delete-element.ts:1-12 (handler)

  Main tool handler function deleteElementTool that parses input args using ElementIdSchema, calls client.deleteElement(id), and returns success/error response
  import type { CanvasClient } from '../canvas-client.js'; import { ElementIdSchema } from '../schemas/element.js'; export async function deleteElementTool( args: unknown, client: CanvasClient ) { const { id } = ElementIdSchema.parse(args); const deleted = await client.deleteElement(id); if (!deleted) throw new Error(`Element ${id} not found`); return { success: true, message: `Element ${id} deleted` }; }
• src/mcp/index.ts:139-152 (registration)

  Tool registration for 'delete_element' with server.tool(), including description, schema validation, and async handler that calls client.deleteElement
  // --- Tool: delete_element --- server.tool( 'delete_element', 'Delete an Excalidraw element by ID', { id: IdZ }, async ({ id }) => { try { const deleted = await client.deleteElement(id); if (!deleted) throw new Error(`Element ${id} not found`); return { content: [{ type: 'text', text: `Element ${id} deleted` }] }; } catch (err) { return { content: [{ type: 'text', text: `Error: ${(err as Error).message}` }], isError: true }; } }
• src/mcp/schemas/element.ts:102-106 (schema)

  ElementIdSchema definition using Zod to validate the id parameter (string with max length constraint)
  export const ElementIdSchema = z .object({ id: z.string().max(LIMITS.MAX_ID_LENGTH), }) .strict();
• src/mcp/canvas-client.ts:89-98 (handler)

  Canvas client deleteElement method that performs HTTP DELETE request to /api/elements/{id} endpoint
  async deleteElement(id: string): Promise<boolean> { const res = await fetch( `${this.baseUrl}/api/elements/${this.safePath(id)}`, { method: 'DELETE', headers: this.headers() } ); if (res.status === 404) return false; if (!res.ok) throw new Error(`Canvas error: ${res.status}`); return true; }
• src/mcp/apps/canvas-client-adapter.ts:80-84 (helper)

  Canvas client adapter deleteElement method that performs store.delete operation with logging
  async deleteElement(id: string): Promise<boolean> { const deleted = await this.store.delete(id); if (deleted) logger.debug({ id }, 'Element deleted'); return deleted; }