Read, query, edit and convert xlsx and csv files safely. It opens xlsx, xlsm, xlsb, ods, csv and tsv, guesses the header row on a messy export, and queries with an expression language that has no eval.
Cursor has the workspace open, which means the spreadsheet next to your code is one sentence away, and the output CSV lands in the same tree the editor is showing.
| You say | Tool |
|---|---|
| Open sales.xlsx and tell me what's in it. | sheet_info |
| Which rep sold the most units in the North region? Top 5 with totals. | sheet_query |
| Add a Revenue column that's Units times Unit Price, save it as a CSV next to the original. | sheet_add_column |
The group-by ranking above used to cost five tool calls and 71 seconds via a python fallback. It is one sheet_query call here.
The file is .cursor/mcp.json, and the key inside it is mcpServers.
| Scope | Path |
|---|---|
| This project only | <project>/.cursor/mcp.json |
| Every project | ~/.cursor/mcp.json |
{
"mcpServers": {
"spreadsheet": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@theluckystrike/mcp-spreadsheet"]
}
}
}The Customize page shows the server and its tools once it has started.
The npm publish of @theluckystrike/mcp-spreadsheet is pending; until then use the .mcpb bundle or a clone and build from the latest release.
The same server runs at https://mcp.zovo.one/mcp/spreadsheet over MCP streamable HTTP, no install. Mint a free token with curl https://mcp.zovo.one/mcp/token, or use a Pro key. It has no filesystem, so a file comes back as a one-hour download link.
{
"mcpServers": {
"spreadsheet": {
"url": "https://mcp.zovo.one/mcp/spreadsheet",
"headers": { "Authorization": "Bearer <token>" }
}
}
}The current field table marks `type` as required, with `stdio` for a locally launched server, so write it out rather than relying on command and args alone. The other documented restriction is that `envFile` is stdio-only: a remote HTTP or SSE server does not read it, and its headers belong in the config.
Free: read, query, stats and find up to 5,000 rows; writes up to 500 rows, never partial. Pro is $19 once, verified offline.
<project>/.cursor/mcp.json applies to that project and can be committed, which suits a server tied to one client. ~/.cursor/mcp.json applies everywhere. Both are managed from the Customize page.
The current field table marks type as required, with stdio for a locally launched server, so include it. Pointing at a remote endpoint, envFile is documented as stdio-only and is not read.
Servers in Cursor's marketplace get an Add to Cursor button. The deeplink reference currently documents prompt, command and rule links only, so for MCP Spreadsheet pasting the config block above is the supported route.
MCP Spreadsheet in detail · The same server in Claude Code and VS Code · Every server in Cursor · Guides · Cursor docs