Skip to content
MCP server

GridPath

Excel MCP server that edits real .xlsx files with live formulas and a review before save

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.5.0
Listing updated
2 days ago

About GridPath

GridPath is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add gridpath -- npx -y gridpath

Add to claude_desktop_config.json

{
  "mcpServers": {
    "gridpath": {
      "command": "npx",
      "args": [
        "-y",
        "gridpath"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gridpath": {
      "command": "npx",
      "args": [
        "-y",
        "gridpath"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

MCP server is free; source is public

Prices change. Check gridpath.dev before you buy.

GridPath 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 to GridPath

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  6. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents