List all sheets in an Excel workbook with their dimensions and metadata.

Returns sheet names, row/column counts, data ranges, merged cell counts, and total embedded image count. Use this to understand the structure of an Excel file before reading its contents.

@param file_path: Absolute path to the .xlsx file. @return: Formatted text with workbook structure overview.

Read cell data from an Excel sheet with pagination for large files.

Returns cell values organized by row with coordinate labels. Supports pagination via start_row and max_rows for efficient handling of large spreadsheets.

@param file_path: Absolute path to the .xlsx file. @param sheet_name: Sheet to read. None = first/active sheet. @param start_row: Starting row number (1-indexed). @param max_rows: Maximum rows to return (default 200). @return: Formatted text table with cell values.

Extract all embedded images from an Excel file.

Uses dual extraction strategy: cell-position mapping (primary) and ZIP archive scanning (fallback) to ensure no images are missed. Returns images as base64-encoded ImageContent that AI can visually analyze.

@param file_path: Absolute path to the .xlsx file. @param sheet_name: Specific sheet, or None for all sheets. @param max_width: Max width in pixels for image optimization (default 1024). @param max_height: Max height in pixels for image optimization (default 1024). @return: Mixed list of TextContent (metadata) and ImageContent (images).

Read the FULL content of an Excel file including all text data AND embedded images.

This is the primary tool for comprehensive document analysis. Returns all sheet data as structured text followed by all extracted images with their cell positions. Ideal for analyzing documents where both text and diagrams/screenshots are essential, such as requirement definitions, reports, or design specs.

For very large files, data is paginated per sheet. Image extraction uses dual strategy (cell-mapping + archive) for maximum coverage.

@param file_path: Absolute path to the .xlsx file. @param max_rows_per_sheet: Max rows to read per sheet (default 500). @param max_image_width: Max width for image optimization (default 1024). @param max_image_height: Max height for image optimization (default 1024). @return: Mixed list of TextContent and ImageContent covering entire workbook.

Get a quick summary overview of an Excel workbook.

Returns file metadata, sheet list with dimensions, image count, and merged cell information. Use this for a fast assessment before deeper analysis.

@param file_path: Absolute path to the .xlsx file. @return: Formatted text summary.

Search for text content across all cells in an Excel workbook.

Performs case-insensitive substring search and returns matching cells with their coordinates and values. Limited to 100 results.

@param file_path: Absolute path to the .xlsx file. @param query: Text to search for. @param sheet_name: Limit to specific sheet, or None for all sheets. @return: Formatted text with search results.