# KitchenSink4XL

> KitchenSink4XL is an open-source MCP server for files and documents. Edit Excel workbooks with an AI that labels every number as calculated, cached or missing. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Windows, Linux
- **Website:** https://community.kitchensink4.ai/xl/
- **Repository:** https://github.com/kitchensink4ai/kitchensink4xl
- **MCP Registry name:** io.github.KitchenSink4AI/kitchensink4xl
- **Categories:** files and documents, productivity
- **Listing updated:** 2026-11-15

## About

A saved workbook keeps the last answer each formula produced, not proof it is current. This server tells the agent which it is: every formula result comes labelled as freshly calculated, remembered from the last save, or never calculated, with affected cells named. Typed-in values carry no label because there is nothing to recalculate. On Windows with Excel installed it can ask Excel to recalculate for real.

Structural edits aim to move everything that should move. Inserting or deleting rows and columns updates formulas, tables, named ranges, charts and cross-sheet references, and the result is checked against Excel's own behaviour; if an edit cannot be done safely the server refuses rather than guesses. A backup is made before each change and a check runs after each save, and ordinary cell edits keep the rest of the file byte for byte.

Version 2.0 offers 131 actions in seven tools for about 5.5k tokens, including an xl_read tool for looking without touching and an xl_help tool for arguments and examples. It is the AGPL-3.0 Community edition, needs Python 3.12 or newer, and runs on Windows and Linux, with macOS untested.

## Features

- **Freshness labels:** Marks each formula value as calculated, cached or missing.
- **Safe structural edits:** Row and column changes carry formulas, tables, names and charts along.
- **Backup and check:** Backs up before changes and verifies after saving.
- **Dynamic array formulas:** Writes spill formulas so Excel shows the whole result.
- **Large-table reading:** Reads a range or summarises a table without loading every row.
- **Excel-powered extras:** With Excel on Windows: real recalculation, pivots, goal seek and PDF export.

## Good for

- Check whether a total in a report is stale
- Insert a column without breaking summary sheets
- Write formulas and number formats into an existing workbook
- Import or export CSV and JSON
- Scan a workbook for structural problems before sharing

## Install

### Claude Code (Terminal)

```sh
claude mcp add kitchensink4xl -- uvx kitchensink4xl
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "kitchensink4xl": {
      "command": "uvx",
      "args": [
        "kitchensink4xl"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "kitchensink4xl": {
      "command": "uvx",
      "args": [
        "kitchensink4xl"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "kitchensink4xl": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "kitchensink4xl"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "kitchensink4xl": {
      "command": "uvx",
      "args": [
        "kitchensink4xl"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "kitchensink4xl": {
      "command": "uvx",
      "args": [
        "kitchensink4xl"
      ]
    }
  }
}
```

## Tools

- `xl_read`: Read-only inspection of workbooks and values
- `xl_help`: Arguments and a worked example for any action

## FAQ

### What does the cached label mean?

The value was remembered from the last save and may be out of date.

### Which licence applies?

The free Community edition is AGPL-3.0.

### Does it need Excel installed?

Only for recalculation, pivot tables and PDF export, which require Windows with Excel.

### What file types does it handle?

The README says .xlsx and .xlsm.

### What Python version is needed?

Python 3.12 or newer.

### Is KitchenSink4XL free?

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

### How do I add KitchenSink4XL to Claude Code?

Run this command in your terminal: claude mcp add kitchensink4xl -- uvx kitchensink4xl

### What are the best alternatives to KitchenSink4XL?

The closest alternatives to KitchenSink4XL are Ha MCP, Concord MCP, note1, ASTra and CalderFlow.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/kitchensink4xl
