GridPath
Excel MCP server that edits real .xlsx files with live formulas and a review before save
- 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 gridpathAdd to claude_desktop_config.json
{
"mcpServers": {
"gridpath": {
"command": "npx",
"args": [
"-y",
"gridpath"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"gridpath": {
"command": "npx",
"args": [
"-y",
"gridpath"
]
}
}
}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

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

CARTESIAN ECU
MCP serverCheck and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)
Not checked yet- 5 tools
- Remote
- Paid
- Files and documents