# SheetXL

> SheetXL is the Excel-compatible spreadsheet engine your agents, your apps and your servers can run. It gives AI agents (Claude Code, Codex, Cursor, any MCP-capable harness) a real calculation engine with 545+ Excel-compatible functions, typed cell values, sandbox sessions with undo, and a human-in-the-loop grid. The same engine ships as an embeddable React component and a headless SDK for TypeScript and Node.

SheetXL runs locally, in the agent's process or a local MCP server. Workbooks are never uploaded. The UI, skills and formula functions are MIT licensed; the engine has a free evaluation license and commercial licensing for production.

## Install for an agent

- Skills (one prompt, any agent): `npx -y skills add sheetxl/skills -g --all`
- MCP server: `npx -y @sheetxl/mcp` (Claude Code: `claude mcp add sheetxl -- npx -y @sheetxl/mcp`, or the plugin: `claude plugin marketplace add sheetxl/skills` then `claude plugin install sheetxl@sheetxl`)
- CLI: `npx -y sheetxl book.xlsx` to open a workbook, `npx -y sheetxl -e "wb.getRange('B2:D9').getStats()" book.xlsx` to run code against it
- VS Code extension: `code --install-extension sheetxl.sheetxl-vscode --pre-release` (the grid beside the agent: shared sessions, live highlights, in-grid prompts; brings its own MCP server, no Node needed)
- SDK: `npm install @sheetxl/sdk` (headless), `@sheetxl/react` and `@sheetxl/studio-mui` (UI)

## Docs

- [Agent quickstart](https://docs.sheetxl.com/guides/getting-started/agent): install the skill, first tasks, wiring up MCP and VS Code
- [CLI](https://docs.sheetxl.com/guides/getting-started/cli): run TypeScript against a workbook from the shell
- [VS Code](https://docs.sheetxl.com/guides/getting-started/vscode): install the extension, open a workbook, ask the agent — each step with its command form
- [React](https://docs.sheetxl.com/guides/getting-started/react): embed the Studio or the grid in an app
- [Node](https://docs.sheetxl.com/guides/getting-started/node): headless calculation on the server
- [Guides](https://docs.sheetxl.com/guides): concepts, how-tos and use cases
- [API reference](https://api.sheetxl.com): the full TypeScript API
- [Demos](https://www.sheetxl.com/demos): interactive examples
- [Skills repository](https://github.com/sheetxl/skills): the agent skill and its reference files

## Benchmarks

- SpreadsheetBench verified-400: 97% (388/400), the highest score of any vendor that has published its results
- Per task on the same 400 tasks: about 3k output tokens, 3.4× fewer than Grid Agent and about 7× fewer than an agent reading the file with Python
- [How the run was made](https://www.sheetxl.com/benchmarks/spreadsheetbench): method, cost per task, and the public outputs and logs
## Product

- [SheetXL for Apps](https://www.sheetxl.com/embed): a spreadsheet component, per app per year
- [SheetXL for Servers](https://www.sheetxl.com/server): a headless library and CLI for Node, per app per year
- [SheetXL for Agents](https://www.sheetxl.com/agent): a plugin for Claude Code, Codex, Cursor and VS Code, on your machine, per person
- [Pricing](https://www.sheetxl.com/pricing): apps pay per app, people pay per person, trying it is free everywhere
- [Changelog](https://www.sheetxl.com/changelog)
- [GitHub](https://github.com/sheetxl/sheetxl)
- [Discord](https://discord.gg/NTKdwUgK9p)

## Legal

- [Security](https://www.sheetxl.com/security): what runs where, what leaves the machine, how licenses are checked
- [Privacy](https://www.sheetxl.com/privacy)
- [Terms](https://www.sheetxl.com/terms)
- [End user license agreement](https://www.sheetxl.com/eula)