Skip to content
MCP server

Kilnshell

Fast local MCP for shell, files, search, processes, PDF, Excel and Word

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

About Kilnshell

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

Kilnshell started as a profiled clone of Desktop Commander 0.3.1 and keeps the same tools, arguments and config file, so it can replace it directly. The README's benchmark on an Apple Silicon Mac reports speed-ups from 11x to 122x per call, and gives a command to reproduce it.

Most of the gain comes from reading the shell login profile once instead of on every command, avoiding spawned processes per call and counting lines natively. It also adds tools that cut round trips: batch for several calls in one request, wait_for for ports, files, URLs or processes, and options to wait for process exit or complete a search in one call.

It removes telemetry, remote feature flags downloaded every five minutes, system-instruction text appended to tool results, the first-run welcome page and the remote mode. The only network call is an update check to npm, which can be disabled. Security controls such as allowedDirectories and blockedCommands remain, and the project is MIT-licensed.

Install

Run in a terminal

claude mcp add kilnshell -- npx -y https://github.com/Soflutionltd/kilnshell/releases/download/v1.0.5/kilnshell.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "kilnshell": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Soflutionltd/kilnshell/releases/download/v1.0.5/kilnshell.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "kilnshell": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Soflutionltd/kilnshell/releases/download/v1.0.5/kilnshell.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "kilnshell": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Soflutionltd/kilnshell/releases/download/v1.0.5/kilnshell.mcpb"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "kilnshell": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Soflutionltd/kilnshell/releases/download/v1.0.5/kilnshell.mcpb"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "kilnshell": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Soflutionltd/kilnshell/releases/download/v1.0.5/kilnshell.mcpb"
      ]
    }
  }
}

Tools this server provides (26)

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

batch
Run several tool calls in one request.
wait_for
Wait until a port, file, URL or process is ready.
start_process
Start a terminal process.
interact_with_process
Send input to a running process.
read_process_output
Read process output, optionally waiting for exit.
list_sessions
List terminal sessions.
list_processes
List running processes.
force_terminate
Force-terminate a session.
kill_process
Kill a process.
read_file
Read a file, including PDF, Excel and Word.
read_multiple_files
Read several files at once.
write_file
Write a file.
edit_block
Edit part of a file.
create_directory
Create a directory.
list_directory
List a directory.
move_file
Move a file.
get_file_info
Get file information.
start_search
Start a ripgrep search, optionally waiting for results.
get_more_search_results
Fetch further search results.
stop_search
Stop a search.
list_searches
List searches.
write_pdf
Write a PDF.
get_config
Read the configuration.
set_config_value
Change a configuration value.
get_usage_stats
Show usage statistics.
get_recent_tool_calls
Show recent tool calls.

What it does

Cached shell profile
Runs the login profile once, not per command.
Batching
Several calls in one request, results in order.
wait_for
Waits for a port, file, URL or process instead of sleep loops.
Document handling
Reads and edits PDF, Excel and Word, and writes PDFs.
Ripgrep search
Code search that can return all results in one call.
No telemetry
Removes usage reporting and injected instructions.

Good for

  • Give an agent fast terminal and file access
  • Run a dev server and wait until its port opens
  • Search a codebase and edit files in one batch
  • Read or edit a spreadsheet or Word file

Pricing

Open source

MIT licence

Kilnshell FAQ

Is it a drop-in replacement for Desktop Commander?

The README says yes: same tools, arguments and config file, with additions only.

Does it send telemetry?

No. It makes no network call of its own except an optional npm update check.

How is it installed?

As a .mcpb bundle for Claude Desktop, a Claude Code plugin, or npx kilnshell for other clients.

What licence?

MIT.

Is Kilnshell free?

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

How do I add Kilnshell to Claude Code?

Run this command in your terminal: claude mcp add kilnshell -- npx -y https://github.com/Soflutionltd/kilnshell/releases/download/v1.0.5/kilnshell.mcpb

What are the best alternatives to Kilnshell?

The closest alternatives to Kilnshell are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Kilnshell

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools