Skip to content
MCP server

KitchenSink4XL

Edit Excel workbooks with an AI that labels every number as calculated, cached or missing

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Windows, Linux
Runs
Locally
Version
2.0.0
Listing updated
2 days ago

About KitchenSink4XL

KitchenSink4XL is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add kitchensink4xl -- uvx kitchensink4xl

Add to claude_desktop_config.json

{
  "mcpServers": {
    "kitchensink4xl": {
      "command": "uvx",
      "args": [
        "kitchensink4xl"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "kitchensink4xl": {
      "command": "uvx",
      "args": [
        "kitchensink4xl"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Free Community edition, AGPL-3.0

Prices change. Check community.kitchensink4.ai before you buy.

KitchenSink4XL 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 to KitchenSink4XL

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  6. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents