Server data from the Official MCP Registry
MCP server for spreadsheet files (.xlsx, .csv, .ods) - cell-level ops + DuckDB SQL engine.
MCP server for spreadsheet files (.xlsx, .csv, .ods) - cell-level ops + DuckDB SQL engine.
Valid MCP server (1 strong, 4 medium validity signals). 3 known CVEs in dependencies (0 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry.
5 files analyzed · 4 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-marekrost-mcp-server-spreadsheet": {
"args": [
"mcp-server-spreadsheet"
],
"command": "uvx"
}
}
}From the project's GitHub README.
mcp-name: io.github.marekrost/mcp-server-spreadsheet
Data-first MCP server for reading and writing spreadsheet files (.xlsx, .csv, .ods).
.xlsx), CSV (.csv), and OpenDocument (.ods) files through a unified tool interface.file and sheet explicitly; no handles or sessions.os.replace() into the target path.default.No local checkout needed — just configure your MCP client (see below).
git clone https://github.com/marekrost/mcp-server-spreadsheet.git
cd mcp-server-spreadsheet
uv sync
Add to your claude_desktop_config.json:
Using PyPI (recommended):
{
"mcpServers": {
"mcp-server-spreadsheet": {
"command": "uvx",
"args": ["mcp-server-spreadsheet"]
}
}
}
Using local source:
{
"mcpServers": {
"mcp-server-spreadsheet": {
"command": "uv",
"args": ["run", "--directory", "/path/to/mcp-server-spreadsheet", "main.py"]
}
}
}
Add to your .mcp.json:
Using PyPI (recommended):
{
"mcpServers": {
"mcp-server-spreadsheet": {
"command": "uvx",
"args": ["mcp-server-spreadsheet"]
}
}
}
Using local source:
{
"mcpServers": {
"mcp-server-spreadsheet": {
"command": "uv",
"args": ["run", "--directory", "/path/to/mcp-server-spreadsheet", "main.py"]
}
}
}
# PyPI
uvx mcp-server-spreadsheet
# Local source
uv run main.py
| Format | Sheets | Formulas | Types |
|---|---|---|---|
.xlsx | Multiple | Preserved as strings | Native (int, float, date, bool) |
.ods | Multiple | Not preserved | Native (int, float, date, bool) |
.csv | Single (default) | N/A | Inferred on load (int, float, text) |
Sheet management tools (add_sheet, delete_sheet, copy_sheet) raise an error for CSV files.
| Tool | Description |
|---|---|
list_workbooks | List all spreadsheet files in a directory (non-recursive) |
create_workbook_file | Create a new empty spreadsheet file (format by extension) |
copy_workbook | Copy an existing file to a new path |
| Tool | Description |
|---|---|
list_sheets | List all sheet names in a workbook |
add_sheet | Add a new sheet (optional name and position) |
rename_sheet | Rename an existing sheet |
delete_sheet | Delete a sheet by name |
copy_sheet | Duplicate a sheet within a workbook (optional new name and position) |
| Tool | Description |
|---|---|
read_sheet | Read entire sheet as rows (optional row/column bounds) |
read_cell | Read a single cell value, e.g. B3 |
read_range | Read a rectangular range, e.g. A1:D10 |
get_sheet_dimensions | Get row and column count of the used range |
| Tool | Description |
|---|---|
write_cell | Write a value to a single cell |
write_range | Write a 2D array starting at a given cell |
append_rows | Append rows after the last used row |
insert_rows | Insert blank or pre-filled rows at a position (shifts rows down) |
delete_rows | Delete rows by index (shifts rows up) |
clear_range | Clear values in a range without removing rows/columns |
copy_range | Copy a block of cells to another location (optionally to a different sheet) |
| Tool | Description |
|---|---|
insert_columns | Insert blank columns at a position |
delete_columns | Delete columns by index |
| Tool | Description |
|---|---|
search_sheet | Search for a value or regex pattern, returns matching cell references |
| Tool | Description |
|---|---|
describe_table | Inspect column names, inferred types, row count, and sample values |
sql_query | Execute a read-only SQL SELECT (supports JOINs across sheets, GROUP BY, aggregates, subqueries) |
sql_execute | Execute INSERT INTO, UPDATE, or DELETE FROM — writes changes back to the file |
SQL examples:
-- Filter and sort
SELECT name, revenue FROM Sales WHERE status = 'Active' ORDER BY revenue DESC LIMIT 20
-- Cross-sheet JOIN
SELECT o.order_id, c.name FROM Orders o JOIN Customers c ON o.customer_id = c.id
-- Aggregate
SELECT department, COUNT(*) AS n, AVG(salary) AS avg FROM Employees GROUP BY department
-- Mutate
UPDATE Sales SET status = 'Closed' WHERE quarter = 'Q1' AND revenue < 1000
DELETE FROM Logs WHERE date < '2024-01-01'
Sheet names with spaces must be quoted: SELECT * FROM "Q1 Sales".
Every sheet-level tool accepts:
| Parameter | Required | Description |
|---|---|---|
file | yes | Path to the spreadsheet file (.xlsx, .csv, or .ods) |
sheet | no | Sheet name. Defaults to the first sheet in the workbook |
All row/column indices are 1-based. Cell references use A1 notation (A1, $B$2).
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
by mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
by mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.