# xlvane: XLSX workbooks

> xlvane: XLSX workbooks is an open-source MCP server for files and documents. Inspect, diff, validate and edit XLSX workbooks from an agent, inside chosen folders. It runs locally on your machine and is started by your AI client.

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

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add xlvane -- npx -y @xlvane/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "xlvane": {
      "command": "npx",
      "args": [
        "-y",
        "@xlvane/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "xlvane": {
      "command": "npx",
      "args": [
        "-y",
        "@xlvane/mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "xlvane": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@xlvane/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "xlvane": {
      "command": "npx",
      "args": [
        "-y",
        "@xlvane/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "xlvane": {
      "command": "npx",
      "args": [
        "-y",
        "@xlvane/mcp"
      ]
    }
  }
}
```

## Tools

- `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.

## 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

- [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/xlvane-xlsx-workbooks
