English Français العربية

xlvane: XLSX workbooks

Official registry Other

XLSX tools: inspect, read, diff and validate workbooks; write, edit and convert with --allow-write.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @xlvane/mcp
Claude Code 
claude mcp add xlvane-xlsx-workbooks -- npx -y @xlvane/mcp@1.3.0 --root
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "xlvane-xlsx-workbooks": {
            "command": "npx",
            "args": [
                "-y",
                "@xlvane/mcp@1.3.0",
                "--root"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. xlvane
  2. Packages
  3. Command line in 5 minutes
  4. MCP server, Agent Skill and offline docs
  5. Development
  6. License

xlvane

An MIT-licensed library for reading and writing XLSX files, designed for input from untrusted sources.

Website: xlvane.github.io (guide, error codes, an in-browser demo). Status: published on npm (xlvane, @xlvane/compat). Install with npm install xlvane (and npm install @xlvane/compat for the exceljs-compatible API). Changes for users are in CHANGELOG.md; how releases are made is in docs/RELEASING.md.

Packages

PackageContentsRuntime dependencies
xlvaneCore library (safe reading, inspect(), writing with styles, task API, streaming) and the xlvane command linefflate
@xlvane/compatexceljs-compatible API (docs/exceljs-compat.md)xlvane
@xlvane/mcpMCP server for AI agents and other MCP clientsxlvane, @modelcontextprotocol/server

Command line in 5 minutes

npm install -g xlvane                    # or use npx xlvane in a project
xlvane                                   # overview and common commands
xlvane inspect report.xlsx               # sheets, columns, header rows, warnings
xlvane read report.xlsx --sheet Sales    # print a sheet as a table
xlvane convert report.xlsx sales.csv     # XLSX ⇄ CSV / JSON
xlvane create data.json report.xlsx      # formatted report from JSON or CSV
xlvane diff old.xlsx new.xlsx            # what changed
xlvane help <command>                    # usage and examples

Add --json to any command for machine-readable output (docs/cli-json.md). More in packages/xlvane/README.md.

MCP server, Agent Skill and offline docs

  • npx @xlvane/mcp --root ./data (or xlvane mcp --root ./data) serves the tools inspect_workbook, read_table, diff and validate for files inside ./data; --allow-write adds write_table, edit_cells and convert. See packages/mcp/README.md.
  • skills/xlvane/SKILL.md is an Agent Skill with instructions and examples. Install it into a project with one command of the skills CLI: npx skills add ./node_modules/xlvane/skills --skill xlvane after npm install xlvane (works offline), or npx skills add <path-to-a-clone-of-this-repository>/skills --skill xlvane.
  • The xlvane package also ships its documentation (docs/) and llms-full.txt (README, skill and docs in one file), so it is readable without network access.

Development

Requires Node.js 22.18+, 24.11+ or 26+ (the range supported by the build and test tools).

npm install
npm test            # unit, security, policy and corpus tests
npm run fuzz        # property-based tests with many runs
npm run typecheck   # TypeScript
npm run check:pkg   # build, publint, attw and package policy checks

How to report problems and propose changes is in CONTRIBUTING.md. Project rules are in CLAUDE.md, decisions and verified format facts in docs/decisions.md, and the security policy in SECURITY.md.

License

MIT. @xlvane/compat is an independent project, not affiliated with or endorsed by the exceljs project or its authors; its LICENSE includes the exceljs MIT notice, because its API and type declarations follow exceljs 4.4.0.

Frequently asked questions

What is xlvane: XLSX workbooks?

XLSX tools: inspect, read, diff and validate workbooks; write, edit and convert with --allow-write.

How do I install xlvane: XLSX workbooks?

It runs on your machine. In Claude Code: claude mcp add xlvane-xlsx-workbooks -- npx -y @xlvane/mcp@1.3.0 --root. For other clients, paste the JSON configuration from this page into their MCP settings.

Does xlvane: XLSX workbooks need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is xlvane: XLSX workbooks open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains xlvane: XLSX workbooks?

It is published by DevXord. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.