Excalidraw MCP Server

Instructions

Implementation Reference

• src/index.js:493-508 (handler)

  The main handler logic for the 'ungroup_elements' tool. It validates the input using GroupIdSchema, checks if the group exists in sceneState.groups, retrieves the element IDs, deletes the group, and returns a success response with the details.
  case 'ungroup_elements': { const params = GroupIdSchema.parse(args); const { groupId } = params; if (!sceneState.groups.has(groupId)) { throw new Error(`Group ${groupId} not found`); } const elementIds = sceneState.groups.get(groupId); sceneState.groups.delete(groupId); const result = { groupId, ungrouped: true, elementIds }; return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] }; }
• src/index.js:56-58 (schema)

  Zod schema used for input validation of the groupId parameter in the ungroup_elements handler.
  const GroupIdSchema = z.object({ groupId: z.string() });
• src/index.js:197-206 (registration)

  Tool registration in the MCP server capabilities, including the description and input schema definition.
  ungroup_elements: { description: 'Ungroup a group of elements', inputSchema: { type: 'object', properties: { groupId: { type: 'string' } }, required: ['groupId'] } },
• src/index.js:767-775 (schema)

  Duplicate schema definition in the ListToolsRequestHandler for consistency.
  name: 'ungroup_elements', description: 'Ungroup a group of elements', inputSchema: { type: 'object', properties: { groupId: { type: 'string' } }, required: ['groupId'] }