# xlvane MCP server

> An MCP server that lets an AI client inspect, read, write, edit, convert, compare, and validate XLSX files within specified directories.

- Repository: https://github.com/DevXord/xlvane
- Page: https://hostedmcp.org/servers/devxord/xlvane
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 1.3.4

## Install

### Claude Code

```sh
claude mcp add xlvane -- npx -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"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"xlvane","type":"stdio","command":"npx","args":["-y","@xlvane/mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex

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

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.xlvane]
command = "npx"
args = ["-y", "@xlvane/mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user xlvane npx -- -y @xlvane/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## Tools (4)

- `inspect_workbook`: Describes an XLSX file without changing it: sheets (including hidden ones), used ranges, detected header rows, column types with sample values, merged cells, example formulas, pictures and charts (position, chart types, title, series count), and warnings (macros, external links, damaged parts). Macros are never run and links are never followed. Use it before read_table to find the sheet and header row. (read-only)
- `read_table`: Reads a sheet as an array of row objects keyed by the header row (or by column letters with header: false). Dates are returned as ISO 8601 strings in UTC, error cells as their code (e.g. "#N/A"), formulas as their cached result. Returns at most 1000 rows per call; use offset to page through larger sheets (totalRows and truncated say whether more rows exist). (read-only)
- `diff`: Compares two XLSX files cell by cell (values and formulas; formatting with styles: true). Sheets are matched by name. Use it to check the result of an edit. (read-only)
- `validate`: Reports read warnings of an XLSX file and, with columns, checks a table: each listed column must exist in the header row, its cells must not be empty unless optional is true, and must have the given type. Each problem names the cell. ok is false when problems were found (warnings count only with strict: true). (read-only)

## FAQ

### Is there a limit to the file size I can process?

Yes, you can configure the --max-file-size option, which defaults to 64 MiB.

### How does the server handle security and directory access?

The server only reads and writes files within the directories specified by the --root argument and prevents access to paths outside those roots.

### Does the server execute macros or formulas?

No, the server does not run macros, follow external links, or calculate formulas.
