Xlsx For AI MCP Server

Short name: xfa - a real CLI command (xfa , xfa samples, xfa --version) and the prompt shorthand (e.g. "use xfa to read this file"). Same entrypoint as xlsx-for-ai; matches the internal xfa_ / XFA_ brand surface. Its README documents 19 tools, including xlsx_read, xlsx_validate, xlsx_describe. It runs locally over stdio via the published package.

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-22 · ★ 5 · #98 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25

MIT · JavaScript servers · how we verify → /methodology

01 · Install Xlsx For AI

before you install - you'll need

XFA_PRIVACY

Environment variables documented in the project's README - it lists which are required and which have defaults.

Claude Code

claude mcp add senoff-xlsx-for-ai -- npx -y xlsx-for-ai

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "senoff-xlsx-for-ai": {
      "command": "npx",
      "args": [
        "-y",
        "xlsx-for-ai"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package xlsx-for-ai - unscoped; check the name against the project README before installing

registry namespace io.github.senoff is GitHub-verified and matches the repo owner

03 · What Xlsx For AI can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can read an .xlsx file by path and return a rendered markdown/JSON/SQL representation, extract every formula in a LOCAL .xlsx workbook - cell coord (A1), formula text, cached result. openpyxl-style read-only metadata, list sheet names, dimensions, and visibility for a LOCAL .xlsx file, and list all defined names (named ranges) in a LOCAL .xlsx workbook - name, scope (workbook or sheet), kind (cell / range / formula), reference.

The 19 tools it gives your agent

Extracted from the project's README - what xlsx-for-ai lets an agent do.

xlsx_read: - read an .xlsx file by path and return a rendered markdown/JSON/SQL representation.
xlsx_validate: - cross-engine consistency check on a LOCAL .xlsx file - runs the workbook through TWO independent renderers (@protobi/exceljs and @cj-tech-master/excelts) and re
xlsx_describe: - pandas-style df.describe() per column - count, nulls, unique, min/max/mean/std for numerics, dtype with purity score.
xlsx_formulas: - extract every formula in a LOCAL .xlsx workbook - cell coord (A1), formula text, cached result. openpyxl-style read-only metadata.
xlsx_hyperlinks: - list every hyperlink in a workbook with its anchor cell, target URL/anchor, display text, tooltip, and a kind classifier (external / internal / mailto / unknown
xlsx_list_sheets: - list sheet names, dimensions, and visibility for a LOCAL .xlsx file.
xlsx_named_ranges: - list all defined names (named ranges) in a LOCAL .xlsx workbook - name, scope (workbook or sheet), kind (cell / range / formula), reference.
xlsx_schema: - infer column schema of a LOCAL .xlsx file - types, nullable flags, header row, sample values.
xlsx_tables: - list every Excel ListObject ("Format as Table" structures) in a LOCAL .xlsx workbook - name, sheet, range, header/totals flags, columns.
xlsx_aggregate: - pandas-style df.groupby([cols]).agg({col: func}) on a LOCAL .xlsx file. funcs: sum / mean / min / max / count / count_distinct.
xlsx_diff: - compute a semantic diff between two LOCAL .xlsx files - cell-level deltas, formula changes, added/removed rows.
xlsx_eval: - evaluate Excel formulas against a LOCAL .xlsx file via HyperFormula. xlwings-style.

show all 19 tools

xlsx_filter: - pandas-style row filter on a LOCAL .xlsx file with predicates AND-combined: eq/ne/gt/gte/lt/lte/contains/in/is_null/not_null.
xlsx_sort: - pandas-style df.sort_values() on a LOCAL .xlsx file with multi-column sort and per-column direction (asc/desc, default asc).
xlsx_value_counts: - pandas-style Series.value_counts() on one column of a LOCAL .xlsx file - count each unique value, sorted by frequency desc, with percentage.
xlsx_redact: - redact PII and sensitive values from a LOCAL .xlsx file before sharing or archiving.
xlsx_write: - create or update a LOCAL .xlsx file from a structured spec.
xlsx_post_slack: - upload a local .xlsx file to a Slack channel as a file attachment, with an optional accompanying message.
xlsx_post_teams: - Upload a local .xlsx file to a Microsoft Teams channel as a file attachment, with an optional accompanying message.

Latest releases

v3.0.16 · 2026-06-08

Belt-and-suspenders on the base64-misread class - 3.0.14 description hardening cut the rate, this closes the failure shape structurally. · Defensive input-contract validation in dispatchTool runs before any server…

v3.0.13 · 2026-06-07

Doc-class - registers xfa as a documented alias for the connector so short prompts route reliably. · xfa is already the internal brand surface (xfa_ API key prefix, XFA_ env vars, XFA_PRIVACY, XFA_WORKBOOK_CACHE_).…

v3.0.11 · 2026-06-07

Doc-only fix on xlsx_read's description. · The prior text claimed it was "the ONLY way to read .xlsx files on the user's local machine" - true in local-CLI (npx) mode where the server IS the user's machine, but wrong…

04 · Who maintains Xlsx For AI

xlsx-for-ai is maintained by senoff. It's the only MCP server we track from this author; the repo dates to Apr 2026.

05 · Facts

repository: github.com/senoff/xlsx-for-ai
category: other - ranked #98 of 848 actively-maintained other servers as of 2026-08-25.
release cadence: 8 releases in the last 90 days (latest 2026-06-08)
registry: io.github.senoff/xlsx-for-ai (active, first published 2026-05-07 · 16 versions)
packages: npm:xlsx-for-ai

06 · Xlsx For AI FAQ

Is Xlsx For AI still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-22 and it shipped 8 releases in the last 90 days. We re-verify nightly.

What can Xlsx For AI do?

How do I install Xlsx For AI?

Run `npx -y xlsx-for-ai`. The README documents one environment variable (XFA_PRIVACY) to set first. You can also paste the ready-made client config above.

Does Xlsx For AI run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Xlsx For AI

Alternatives to Xlsx For AI

Maintained other servers if Xlsx For AI isn't the fit.

More MCP servers to compare · Stata MCP · Acronis MCP · AppDirect MCP · Autotask MCP · ConnectWise Control MCP

More JavaScript MCP servers · Weavatrix · X402station · Speclock · Zen MCP · Indexnow · see all