Skip to content
MCP server

xlvane: XLSX workbooks

Inspect, diff, validate and edit XLSX workbooks from an agent, inside chosen folders

Runs locallyStatus and history
Install
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/mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

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

  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