# slim-sheet

> slim-sheet is an open-source MCP server for files and documents. Spreadsheet MCP that reads xlsx, ods and csv, queries with SQL and edits safely. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/j4flmao/slim-sheet
- **MCP Registry name:** io.github.j4flmao/slim-sheet
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents), [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-18

## About

Built so that small local models can use it, responses stay under a token budget (about 1,500 tokens by default) as Markdown tables with A1 coordinates and cursors. It reads xlsx, xls, ods, numbers, csv, parquet and more locally, with no Office and no network, and runs SQL over sheets with DuckDB.

Three tiers set how many tools load: lite for 3B to 8B models, standard and full. Edits go to a .slim.xlsx copy unless overwrite is set, writes are atomic and journaled, and undo steps back. Structure edits rewrite formulas, names and charts as Excel would, and macros are shown read-only, never run.

One call, build_report, makes a branded one-page dashboard with KPI tiles and charts, and the README lists a formula catalog of 514 functions, anomaly checks and what-if analysis.

## Features

- **Token-budgeted output:** Responses capped with continuation cursors.
- **Tool tiers:** Lite, standard and full sets for different model sizes.
- **Safe edits:** Copy-on-write, atomic writes and undo.
- **One-call dashboards:** build_report creates KPI tiles and charts from a brand.
- **Formula help:** Explain, evaluate and audit formulas.

## Good for

- Summarize a messy spreadsheet
- Clean data and find anomalies
- Build a sales dashboard from a workbook
- Audit formulas for hardcoded numbers

## Install

### Claude Code (Terminal)

```sh
claude mcp add slim-sheet --env SLIM_SHEET_PASSWORD='<SLIM_SHEET_PASSWORD>' -- uvx slim-sheet
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "slim-sheet": {
      "command": "uvx",
      "args": [
        "slim-sheet"
      ],
      "env": {
        "SLIM_SHEET_PASSWORD": "<SLIM_SHEET_PASSWORD>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "slim-sheet": {
      "command": "uvx",
      "args": [
        "slim-sheet"
      ],
      "env": {
        "SLIM_SHEET_PASSWORD": "<SLIM_SHEET_PASSWORD>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "slim-sheet": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "slim-sheet"
      ],
      "env": {
        "SLIM_SHEET_PASSWORD": "<SLIM_SHEET_PASSWORD>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "slim-sheet": {
      "command": "uvx",
      "args": [
        "slim-sheet"
      ],
      "env": {
        "SLIM_SHEET_PASSWORD": "<SLIM_SHEET_PASSWORD>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "slim-sheet": {
      "command": "uvx",
      "args": [
        "slim-sheet"
      ],
      "env": {
        "SLIM_SHEET_PASSWORD": "<SLIM_SHEET_PASSWORD>"
      }
    }
  }
}
```

## Tools

- `overview`: Overview of workbooks.
- `read`: Reads cells.
- `find`: Finds values.
- `query`: SQL over sheets.
- `profile`: Profiles data.
- `write`: Writes cells.
- `explain_formula`: Explains a formula.
- `build_report`: Builds a one-page dashboard.
- `clean`: Cleans data.
- `anomalies`: Detects anomalies and formula issues.
- `merge`: Merges files.
- `convert`: Converts and splits.
- `diff`: Compares workbooks.
- `undo`: Undoes an edit.
- `evaluate`: Evaluates formulas.
- `describe_cell`: Describes and traces a cell.
- `style_sheet`: Styles a sheet.
- `what_if`: What-if analysis.
- `create_workbook`: Creates a workbook.
- `add_chart`: Adds a chart.
- `pivot`: Creates a pivot.
- `recalc`: Recalculates via LibreOffice.

## FAQ

### Which formats?

xlsx, xlsm, xls, xlsb, ods, numbers, csv, tsv, parquet and json.

### Will it overwrite my file?

Not unless overwrite=true; edits go to a .slim.xlsx copy.

### Does it use the network?

The README says no network.

### Is slim-sheet free?

Yes. slim-sheet is open source, so you can use and self-host it for free.

### How do I add slim-sheet to Claude Code?

Run this command in your terminal: claude mcp add slim-sheet --env SLIM_SHEET_PASSWORD='<SLIM_SHEET_PASSWORD>' -- uvx slim-sheet

### What are the best alternatives to slim-sheet?

The closest alternatives to slim-sheet are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, dashboard-icons, Tapetide - Indian Stock Market MCP and World Monitor.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [dashboard-icons](https://ai-powered.com/mcp/dashboard-icons): dashboard-icons is an open-source MCP server for analytics and data.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [DataArcus for Power BI](https://ai-powered.com/mcp/dataarcus-for-power-bi): DataArcus for Power BI is a free MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [SSRS2](https://ai-powered.com/mcp/ssrs2): SSRS2 is an MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/slim-sheet
