Excel reading MCP with embedded image extraction — AI agents see text and images in xlsx files
If you already use Excel, the excel mcp server is the piece that lets your assistant work with it directly. Excel reading MCP with embedded image extraction — AI agents see text and images in xlsx files.
Ask your assistant to review a requirements spec. Half the meaning lives in screenshots, flowcharts, and annotated diagrams pasted into cells — and every Excel MCP server hands the model text only. The answer comes back confident and incomplete, because the model never knew the pictures existed.
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
Cursor — The Cursor tool exposed by this serverlist_sheets — List all sheets with dimensions, merged cell counts, and image totals. Use this first to understand a workbook's structureread_excel_data — Read cell data from a specific sheet with pagination supportextract_images — Extract all embedded images from the workbook as base64 ImageContentget_workbook_overview — Quick structural summary of a workbook — file size, sheet list, dimensions, image countsearch_excel — Case-insensitive text search across all cells in the workbookcreate_excel_file — The create_excel_file tool exposed by this serveradd_excel_sheet — The add_excel_sheet tool exposed by this serverupdate_excel_cells — Set individual cells by coordinate. Values starting with = are written as formulaswrite_excel_rows — The write_excel_rows tool exposed by this serverinsert_excel_image — Insert a local image file into a workbook, anchored at a cellformat_excel_cells — Style a range: font, colors, borders, alignment, number formats. Only the attributes you pass are changed — existing styling is preservedConfiguration is passed through the environment: EXCEL_VISION_MCP_ALLOWED_DIRS. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
The server ships on PyPI as excel-vision-mcp, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.
This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Excel's toolset — Cursor, list_sheets, read_excel_data and 11 more — is a fair guide to whether it matches your workflow. It is maintained by VOYAGER-Inc; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Excel's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| Cursor | The Cursor tool exposed by this server. |
| list_sheets | List all sheets with dimensions, merged cell counts, and image totals. Use this first to understand a workbook's structure. |
| read_excel_data | Read cell data from a specific sheet with pagination support. |
| extract_images | Extract all embedded images from the workbook as base64 ImageContent. |
| get_workbook_overview | Quick structural summary of a workbook — file size, sheet list, dimensions, image count. |
| search_excel | Case-insensitive text search across all cells in the workbook. |
| create_excel_file | The create_excel_file tool exposed by this server. |
| add_excel_sheet | The add_excel_sheet tool exposed by this server. |
| update_excel_cells | Set individual cells by coordinate. Values starting with = are written as formulas. |
| write_excel_rows | The write_excel_rows tool exposed by this server. |
| insert_excel_image | Insert a local image file into a workbook, anchored at a cell. |
| format_excel_cells | Style a range: font, colors, borders, alignment, number formats. Only the attributes you pass are changed — existing styling is preserved. |
| set_excel_column_widths | The set_excel_column_widths tool exposed by this server. |
| Architecture | The Architecture tool exposed by this server. |
{
"mcpServers": {
"excel-vision": {
"command": "uvx",
"args": ["excel-vision-mcp"],
"env": {
"EXCEL_VISION_MCP_ALLOWED_DIRS": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| EXCEL_VISION_MCP_ALLOWED_DIRS | Filesystem location the server is allowed to use. | Optional |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.