# ExStruct MCP server

> Reads Excel workbooks into structured JSON and applies patch-based edits so AI agents can extract, read, and modify spreadsheet data.

- Repository: https://github.com/harumiWeb/exstruct
- Page: https://hostedmcp.org/servers/harumiweb/exstruct
- Transport: —
- Stars: 203
- License: BSD-3-Clause

## FAQ

### What can the ExStruct MCP server do with Excel workbooks?

It extracts workbook data into structured JSON and supports reading cells, ranges, and formulas, capturing sheet images, and applying editing patches or creating new workbooks.

### Which tools does the ExStruct MCP server expose?

Tools include exstruct_extract, exstruct_capture_sheet_images, exstruct_make, exstruct_patch, exstruct_read_json_chunk, exstruct_read_range, exstruct_read_cells, exstruct_read_formulas, and exstruct_validate_input.

### How do I run the ExStruct MCP server without installing it?

Use uvx with the mcp extra, passing options like --root, --log-file, and --on-conflict.

### What does ExStruct extract from a workbook?

It outputs cells, shapes, charts, SmartArt, table candidates, merged-cell ranges, print areas, and hyperlinks depending on the mode.

### Does ExStruct need Excel or LibreOffice installed?

Light mode works via direct OOXML parsing without COM or LibreOffice; richer extraction uses LibreOffice or Excel COM.