# GridPath

> GridPath is an open-source MCP server for files and documents. Excel MCP server that edits real .xlsx files with live formulas and a review before save. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux, Web
- **Website:** https://gridpath.dev/mcp
- **Repository:** https://github.com/pixelsmasher13/gridpath/tree/HEAD/packages/gridpath
- **MCP Registry name:** io.github.pixelsmasher13/gridpath
- **Categories:** files and documents, productivity
- **Listing updated:** 2026-11-14

## About

Every write comes back with a review link showing the changed cells highlighted, recomputed dependents and a before-and-after card for each agent action, with Accept, Reject and Save. Started with the --review-required flag, only that page can write the file. A calculation engine, a fork of IronCalc compiled to WebAssembly, runs inside the server, so the agent sees the effect of an edit on the sheet in the same turn instead of guessing.

Saves rewrite only the package parts an edit touched, and the site says charts, pivots, macros, add-in data and custom XML come back byte-identical. A workbook map and row search help the agent find things in large models, and the site gives one comparison on a 55,000-formula model where a row insert took 17 seconds and $0.35 against 52 seconds and $0.86 through a scripting route. The tools named include describe_workbook and run_script, which runs the agent's JavaScript in a sandboxed worker with a hard timeout and returns one reviewable batch.

It needs only Node, with no Python, openpyxl or Excel install, and works with Claude Code, Claude Desktop, Cursor and Codex. The same engine ships as an npm package for embedding an editable spreadsheet in a web app, and as a desktop app with a built-in agent.

## Features

- **Review before save:** Every change returns a review page with highlighted cells and Accept, Reject and Save.
- **Live formulas:** A WebAssembly calculation engine recomputes results so the agent can read them back.
- **Byte-identical parts:** Untouched charts, pivots, macros and custom XML are left as they were.
- **Workbook map:** Search and mapping tools locate rows in large models with few calls.
- **Sandboxed scripts:** run_script executes JavaScript against the workbook with a timeout.
- **Node only:** No Python environment, LibreOffice or Excel install is needed.

## Good for

- Add a forecast column that follows an existing formula pattern
- Change an input and read the recomputed outputs
- Apply a bulk rule to every row matching a condition
- Edit a financial model without breaking its charts
- Embed an editable spreadsheet in a web app

## Install

### Claude Code (Terminal)

```sh
claude mcp add gridpath -- npx -y gridpath
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gridpath": {
      "command": "npx",
      "args": [
        "-y",
        "gridpath"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gridpath": {
      "command": "npx",
      "args": [
        "-y",
        "gridpath"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gridpath": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "gridpath"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gridpath": {
      "command": "npx",
      "args": [
        "-y",
        "gridpath"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gridpath": {
      "command": "npx",
      "args": [
        "-y",
        "gridpath"
      ]
    }
  }
}
```

## Tools

- `describe_workbook`: Maps the workbook's sheets and structure.
- `run_script`: Runs the agent's JavaScript against the workbook in a sandboxed worker.

## FAQ

### Which agents does it work with?

Claude Code, Claude Desktop, Cursor and Codex.

### What do I need installed?

Only Node; the install line is claude mcp add gridpath -- npx -y gridpath mcp --review-required.

### Can the agent write without my approval?

Not with --review-required: only the review page can write the file.

### Is there a desktop app?

Yes, with the same engine and review, and it is described as free with a Claude or ChatGPT subscription.

### Is GridPath free?

Yes. GridPath is open source, so you can use and self-host it for free.

### How do I add GridPath to Claude Code?

Run this command in your terminal: claude mcp add gridpath -- npx -y gridpath

### What are the best alternatives to GridPath?

The closest alternatives to GridPath are Ha MCP, Concord MCP, note1, ASTra and CalderFlow.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/gridpath
