# io.github.theluckystrike/sheets (mcpb · spreadsheet.mcpb)

Read, filter and edit spreadsheet data - xlsx and csv - from your AI chat. Local processing.

- Trust score: 55/100 (low)
- Change this week: +7
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-20

## Components

- mcpb · `spreadsheet.mcpb`: 55/100 (this document), [markdown](https://verifymcp.io/servers/theluckystrike-sheets/https-github-com-theluckystrike-mcp-servers-releases-download-v0-21-0-spreadshee.md), [page](https://verifymcp.io/servers/theluckystrike-sheets/https-github-com-theluckystrike-mcp-servers-releases-download-v0-21-0-spreadshee)

## Channel facts

- Registry: `mcpb`
- Package: `https://github.com/theluckystrike/mcp-servers/releases/download/v0.21.0/spreadsheet.mcpb`
- Version: `0.21.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-20.

- **Supply Chain Security**: 23/100
  - Malware scan not yet available for this package.
  - Known CVEs were checked across the 105 of 105 dependencies we could resolve, so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - 40 of 105 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 13 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 84/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1448 tokens (~131/item across 11 items; 10 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 43/100
  - Stability observed for 13 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 96/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 87% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 10 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 11 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

- Download bundle: `https://github.com/theluckystrike/mcp-servers/releases/download/v0.21.0/spreadsheet.mcpb`

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-20 (score 55, +1)

No change was recorded against any check on this day. Stability & Change Management went from 40 to 43. That category is still filling its 30-day observation window: 12 days of observed history at the previous scan, 13 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-18 (score 54, +1)

No change was recorded against any check on this day. Stability & Change Management went from 33 to 37. That category is still filling its 30-day observation window: 10 days of observed history at the previous scan, 11 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-16 (score 53, +1)

No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes. Other categories moved too: Supply Chain Security rose 1.

### 2026-09-15 (score 52, +4)

- [functional improvement] Stability: unverified → 0.27

### 2026-09-07 (score 48)

First indexed and scored.

## MCP tools (10)

### `license_status` (~23 tokens)

License status

Show whether this server runs in free or Pro mode and where to upgrade.

### `license_activate` (~42 tokens)

Activate license

Activate a Pro license key (format MCPL1.xxx.yyy). Verified offline and saved locally.

Input parameters:

- `key` (string, required): License key from the checkout confirmation page

### `sheet_info` (~79 tokens)

Spreadsheet overview

Call this tool for any spreadsheet or CSV file path; built-in file readers cannot parse spreadsheets and must not be used for them. Start here: sheet names, size, header row, column types and samples.

Input parameters:

- `path` (string, required): Path to the .xlsx/.xlsm/.xlsb/.ods/.csv/.tsv file (~ is expanded)

### `sheet_read` (~138 tokens)

Read rows

Call this tool for any spreadsheet or CSV file path; built-in file readers cannot parse spreadsheets and must not be used for them. Reads rows as a table, JSON or CSV; page with limit/offset or an A1 range.

Input parameters:

- `as` (string): Output format, default table
- `limit` (integer): Rows to return, default 100
- `offset` (integer): Rows to skip, default 0
- `path` (string, required)
- `range` (string): A1 range such as A1:D50; overrides limit/offset
- `sheet` (string): Sheet name; defaults to the first sheet

### `sheet_query` (~243 tokens)

Filter, group and sort rows

Call this tool for any spreadsheet or CSV file path; built-in file readers cannot parse spreadsheets and must not be used for them. Filters, groups, aggregates and sorts in one call, e.g. where '[Qty] > 10'.

Input parameters:

- `aggregate` (array): Aggregates per group, e.g. [{"col":"Units","fn":"sum","as":"total_units"}]. Defaults to a row count when group_by is given.
- `as` (string)
- `group_by` (array): Group rows by these columns before aggregating, e.g. ["Rep"] or ["Region","Rep"]
- `limit` (integer): Default 100
- `path` (string, required): Path to the .xlsx or .csv file
- `select` (array): Column names to return; default all (with group_by, defaults to the group columns plus the aggregates)
- `sheet` (string)
- `sort` (object): Sort column; may be an aggregate alias such as total_units
- `where` (string): Filter, e.g. [Qty] >= 5 AND ([Status] = "open" OR [Status] = "new")

### `sheet_stats` (~82 tokens)

Column statistics

Call this tool for any spreadsheet or CSV file path; built-in file readers cannot parse spreadsheets and must not be used for them. Whole-column statistics: count, empty, distinct, min, max, sum, mean, median.

Input parameters:

- `columns` (array): Limit to these columns; default all
- `path` (string, required)
- `sheet` (string)

### `sheet_find` (~123 tokens)

Find text

Call this tool to search every cell of a spreadsheet or CSV for text; built-in file readers cannot parse spreadsheets. Matching is case insensitive. Returns cell addresses with a preview of the row each hit is on.

Input parameters:

- `path` (string, required): Path to the .xlsx/.xlsm/.xlsb/.ods/.csv/.tsv file (~ is expanded)
- `sheet` (string): Sheet name; default searches every sheet
- `text` (string, required): Text to look for; matched case insensitively anywhere inside a cell. Up to 200 hits are returned

### `sheet_write` (~230 tokens)

Write rows

Call this tool to write rows to an excel (xlsx) or csv/tsv/json file. Returns the rows, columns, byte size and column names of the file written.

Input parameters:

- `mode` (string, required): new_file writes a brand new file and refuses to clobber an existing one; append adds the rows under the existing data; overwrite replaces the file contents
- `out_path` (string): Where to write; default is a new file next to the source for new_file, or the source itself for append/overwrite. The output format follows this extension: .xlsx, .csv, .tsv or .json. An extension is…
- `path` (string, required): Source file for append/overwrite, or the intended file for new_file (~ is expanded)
- `rows` (array, required): Array of objects, whose keys become the headers, or an array of arrays with the header row first
- `sheet` (string): Sheet to write; default is the first sheet of the source, or "Sheet1" for a new file. Other sheets of an existing workbook are kept unchanged

### `sheet_add_column` (~289 tokens)

Add a column

Call this tool to add a computed column and save the result to a NEW file; the source is never modified unless out_path points at it. Returns the new file path, the row count and a preview of the first rows.

Input parameters:

- `decimals` (integer): Round numeric formula results to this many decimals. Default: the widest decimal count of the columns the formula reads, capped at 2 when they all hold 2 or fewer (money in, money out); otherwise no…
- `formula` (string): Expression over the columns of each row, in the same expression language as sheet_query, e.g. "[Qty] * [Unit Price]" or '[Country] = "PL"'. Give either formula or values
- `name` (string, required): Name of the new column. It must not already exist on the sheet
- `out_path` (string): Output file; default <source>-plus-<column>.<same ext>. The source file is left untouched unless this points at it
- `path` (string, required): Path to the source .xlsx/.xlsm/.xlsb/.ods/.csv/.tsv file (~ is expanded); it is never modified
- `sheet` (string): Sheet name; default is the first sheet
- `values` (array): Explicit values, one per data row, instead of a formula. Missing entries are left blank

### `sheet_convert` (~167 tokens)

Convert file

Call this tool to convert a sheet between excel (xlsx), csv and json. Writes a new file next to the source unless out_path is given; the source is never modified. Returns the new file path with its row and column counts.

Input parameters:

- `out_path` (string): Where to write; default is the source name with the new extension, next to the source. It must differ from the source path
- `path` (string, required): Path to the source .xlsx/.xlsm/.xlsb/.ods/.csv/.tsv file (~ is expanded); it is never modified
- `sheet` (string): Sheet to convert; default is the first sheet. Only that one sheet is written
- `to` (string, required): Target format; the default out_path takes this as its extension

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/theluckystrike-sheets/https-github-com-theluckystrike-mcp-servers-releases-download-v0-21-0-spreadshee#diagnostics

## Score history

- 2026-09-20: 55
- 2026-09-19: 54
- 2026-09-18: 54
- 2026-09-17: 53
- 2026-09-16: 53
- 2026-09-15: 52
- 2026-09-14: 48
- 2026-09-13: 48
- 2026-09-12: 48
- 2026-09-11: 48
- 2026-09-10: 48
- 2026-09-09: 48
- 2026-09-08: 48
- 2026-09-07: 48

## Common questions

### What is the io.github.theluckystrike/sheets MCP server?

io.github.theluckystrike/sheets is an MCP server listed in the public MCP registry as io.github.theluckystrike/sheets. Read, filter and edit spreadsheet data - xlsx and csv - from your AI chat. Local processing. This page covers its MCPB bundle (https://github.com/theluckystrike/mcp-servers/releases/download/v0.21.0/spreadsheet.mcpb).

### Is the io.github.theluckystrike/sheets MCP server safe to use?

io.github.theluckystrike/sheets scores 55 out of 100 on VerifyMCP. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the io.github.theluckystrike/sheets MCP server expose?

io.github.theluckystrike/sheets exposes 10 tools: license_status, license_activate, sheet_info, sheet_read, sheet_query, and 5 more. Their descriptions and schemas cost roughly 1,416 tokens of context every time the server is loaded.

### What licence is the io.github.theluckystrike/sheets MCP server under?

io.github.theluckystrike/sheets declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- Repository: https://github.com/theluckystrike/mcp-servers
- Website: https://mcp.zovo.one/s/spreadsheet
- Changelog RSS feed: https://verifymcp.io/servers/theluckystrike-sheets/https-github-com-theluckystrike-mcp-servers-releases-download-v0-21-0-spreadshee.xml
- Changelog JSON feed: https://verifymcp.io/servers/theluckystrike-sheets/https-github-com-theluckystrike-mcp-servers-releases-download-v0-21-0-spreadshee.json
- HTML version of this page: https://verifymcp.io/servers/theluckystrike-sheets/https-github-com-theluckystrike-mcp-servers-releases-download-v0-21-0-spreadshee