xlvane: XLSX workbooks
Inspect, diff, validate and edit XLSX workbooks from an agent, inside chosen folders
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 1.3.4
- Listing updated
- 3 days ago
About xlvane: XLSX workbooks
xlvane: XLSX workbooks is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.
Spreadsheets are awkward for an agent to handle by writing throwaway scripts. This stdio server gives it seven tools to work on XLSX files directly, built on the xlvane library and the official MCP TypeScript SDK. It needs Node.js 22 or later.
It is read-only by default. The write tools (write_table, edit_cells, convert) are not even registered unless you start it with --allow-write. Every path is confined to the --root directories you pass, checked after symlinks are resolved, and existing files are replaced only when a call sets overwrite to true. Limits are tunable: 64 MiB file size, 1,000 rows per read_table call, about 1 MiB per response and 5,000,000 cells per workbook by default.
Errors come back as tool results with a stable code, location and hint, and every result is returned both as structured content and as JSON text.
Install
Run in a terminal
claude mcp add xlvane -- npx -y @xlvane/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"xlvane": {
"command": "npx",
"args": [
"-y",
"@xlvane/mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"xlvane": {
"command": "npx",
"args": [
"-y",
"@xlvane/mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"xlvane": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@xlvane/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"xlvane": {
"command": "npx",
"args": [
"-y",
"@xlvane/mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"xlvane": {
"command": "npx",
"args": [
"-y",
"@xlvane/mcp"
]
}
}
}Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- inspect_workbook
- Lists sheets, used ranges, header rows, column types, merged cells, formulas and warnings.
- read_table
- Reads sheet rows as objects keyed by the header row, with paging.
- diff
- Shows cell-by-cell differences between two workbooks.
- validate
- Reports read warnings and column rule violations with cell locations.
- write_table
- Writes rows to a new XLSX file with a report preset.
- edit_cells
- Sets cells and appends rows, keeping the rest of the file unchanged.
- convert
- Converts XLSX to CSV, TSV or JSON and back.
What it does
- Workbook inspection
- Lists sheets including hidden ones, used ranges, header rows, column types, merged cells and formulas.
- Paged table reads
- Returns rows as objects keyed by the header row, with ISO 8601 dates and offset paging.
- Cell-level diff
- Compares two workbooks cell by cell.
- Column validation
- Checks column rules for name, type and optionality and names the failing cell.
- Opt-in writing
- Write tools only exist when --allow-write is set.
- Format conversion
- Converts XLSX to CSV, TSV or JSON and back, escaping formula-like text in CSV.
Good for
- Compare two versions of a workbook to see which cells changed
- Check a data sheet against column type rules
- Turn an XLSX into JSON for further processing
- Write a formatted report workbook from rows
- Fix a few cells without disturbing the rest of the file
Pricing
Open source
Free npm package
Prices change. Check xlvane.github.io before you buy.
xlvane: XLSX workbooks FAQ
Can it change my files by default?
No. Without --allow-write the write tools are not registered.
Can it touch files outside a chosen folder?
No. Paths must resolve inside a --root directory, including after symlink resolution.
What are the default limits?
64 MiB per file, 1,000 rows per read_table call, 1 MiB per response and 5,000,000 cells per workbook.
What does it need to run?
Node.js 22 or later.
Is xlvane: XLSX workbooks free?
Yes. xlvane: XLSX workbooks is open source, so you can use and self-host it for free.
How do I add xlvane: XLSX workbooks to Claude Code?
Run this command in your terminal: claude mcp add xlvane -- npx -y @xlvane/mcp
What are the best alternatives to xlvane: XLSX workbooks?
The closest alternatives to xlvane: XLSX workbooks are Ha MCP, Concord MCP, note1, ASTra and CalderFlow.
Alternatives to xlvane: XLSX workbooks

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