# excel-vision-mcp

This MCP server lets an agent read Excel content with embedded images and formatting, then edit workbook cells, formulas, and appearance.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 20
- Author: VOYAGER-Inc
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/VOYAGER-Inc/excel-vision-mcp
- Updated: 2026-07-31
- HTML: https://affpapa.org/en/nevibecode/mcp/excel-vision-mcp

## What it does

The server reads cell text and formulas, marks formatting such as strikethrough and fill color, and returns embedded images linked to their cells. That gives an agent access to a diagram placed in a worksheet and helps distinguish a struck-through row from an active one. Hidden rows and columns are skipped unless `include_hidden=true` is enabled.

It can also create workbooks, edit cells and formulas, add images, and set formatting. Image lookup first maps pictures to cells, then scans the XLSX archive for others. You can run it with `uvx` without installing the package separately; Python 3.11+ is listed as a requirement. Files are processed locally. By default, the server can read and write any Excel file your account can access.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add excel-vision-mcp -- uvx excel-vision-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from excel-vision-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add excel-vision-mcp -- uvx excel-vision-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from excel-vision-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "excel-vision-mcp": {
            "command": "uvx",
            "args": [
                "excel-vision-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from excel-vision-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "excel-vision-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "excel-vision-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from excel-vision-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add excel-vision-mcp uvx excel-vision-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from excel-vision-mcp <command>

## When to use it
- read workbook text, formulas, and embedded images
- locate a diagram by its worksheet cell
- identify struck-through or highlighted rows
- edit workbook cells and formulas
- search text across Excel sheets

## Example prompts
- Read `requirements.xlsx` and explain the diagram in cell `B12`.
- Find struck-through rows and yellow-highlighted cells in `report.xlsx`.
- Create an Excel workbook with a Summary sheet and add formulas to calculate the totals.

## Similar
- [Excel MCP Server](https://affpapa.org/en/nevibecode/mcp/excel-mcp-server.md) — MCP server · ★ 4259
- [kordoc](https://affpapa.org/en/nevibecode/mcp/kordoc.md) — MCP server · ★ 2726
- [Power BI Authoring MCP Server (Local)](https://affpapa.org/en/nevibecode/mcp/power-bi-authoring-mcp-server-local.md) — MCP server · ★ 1247
- [Microsoft 365 MCP Server](https://affpapa.org/en/nevibecode/mcp/microsoft-365-mcp-server.md) — MCP server · ★ 1074
- [anymd](https://affpapa.org/en/nevibecode/mcp/anymd.md) — MCP server · ★ 1051
- [Docling MCP](https://affpapa.org/en/nevibecode/mcp/docling-mcp.md) — MCP server · ★ 777

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md