list_drawings
Retrieve and browse all available Excalidraw drawings stored in the server with pagination controls for organized access.
Instructions
List all Excalidraw drawings
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| perPage | No |
Implementation Reference
- src/operations/drawings.ts:201-239 (handler)The main handler function that lists paginated drawings by reading metadata JSON files from the storage directory, filtering .meta.json files, and parsing their contents.
export async function listDrawings( page: number = 1, perPage: number = 10 ): Promise<{ drawings: any[]; total: number }> { await ensureStorageDir(); try { // Get all files in the storage directory const files = await fs.readdir(STORAGE_DIR); // Filter metadata files const metadataFiles = files.filter((file) => file.endsWith(".meta.json")); // Calculate pagination const start = (page - 1) * perPage; const end = start + perPage; const paginatedFiles = metadataFiles.slice(start, end); // Read metadata for each drawing const drawings = await Promise.all( paginatedFiles.map(async (file) => { const metadataPath = path.join(STORAGE_DIR, file); const metadataStr = await fs.readFile(metadataPath, "utf-8"); return safeJsonParse(metadataStr, "drawing metadata"); }) ); return { drawings, total: metadataFiles.length, }; } catch (error) { console.error("Failed to list drawings:", sanitizeErrorMessage(error)); return { drawings: [], total: 0, }; } } - src/operations/drawings.ts:57-60 (schema)Zod schema defining the input parameters for the list_drawings tool: optional page (default 1) and perPage (default 10, max 100).
export const ListDrawingsSchema = z.object({ page: z.number().int().min(1).optional().default(1), perPage: z.number().int().min(1).max(100).optional().default(10), }); - src/index.ts:86-89 (registration)Tool registration in the listTools response, specifying name, description, and input schema converted from Zod schema.
name: "list_drawings", description: "List all Excalidraw drawings", inputSchema: zodToJsonSchema(drawings.ListDrawingsSchema), },