# Agent Spreadsheet MCP

Gives coding agents a direct way to inspect and recalculate Excel sheets without relying on desktop office suites.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 62
- Author: PSU3D0
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/PSU3D0/agent-spreadsheet
- Updated: 2026-09-09
- HTML: https://affpapa.org/en/nevibecode/mcp/agent-spreadsheet-mcp

## What it does

The server runs on Formualizer, a standalone Rust calculation engine. It evaluates dependency graphs and executes over 400 spreadsheet functions in memory. Because of this, agents do not need Microsoft Excel COM bindings or headless LibreOffice to confirm calculation outputs.

Workbook modifications follow an event-sourced session model with rollback capabilities and dry-run validation. Agents can clone row templates, manage named ranges, and inspect calculation proofs before committing changes to storage.

Legacy `.xls` and `.xlsb` files work strictly in read-only discovery mode; saving edits requires `.xlsx` or `.xlsm` formats. Running the containerized MCP distribution also requires an active Docker daemon.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add agent-spreadsheet-mcp -- docker run -i --rm ghcr.io/psu3d0/agent-spreadsheet:0.16.0-full
```

### Codex

**Platform CLI**
```bash
codex mcp add agent-spreadsheet-mcp -- docker run -i --rm ghcr.io/psu3d0/agent-spreadsheet:0.16.0-full
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agent-spreadsheet-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/psu3d0/agent-spreadsheet:0.16.0-full"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "agent-spreadsheet-mcp": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/psu3d0/agent-spreadsheet:0.16.0-full"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add agent-spreadsheet-mcp docker run -i --rm ghcr.io/psu3d0/agent-spreadsheet:0.16.0-full
```

## When to use it
- recalculate dependency graphs and formulas in XLSX workbooks
- append rows and clone template bands without breaking layout
- verify calculation diffs before writing changes to disk
- inspect legacy XLS and XLSB files in read-only mode

## Example prompts
- Inspect `budget.xlsx`, append the Q3 marketing costs row, and verify that total formulas updated.
- Run a dry-run calculation on `forecast.xlsx` and show the cell diffs before saving.
- Check the named ranges and formula references across sheets in `data_model.xlsx`.

## 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