# Kilnshell

> Kilnshell is an open-source MCP server for files and documents. Fast local MCP for shell, files, search, processes, PDF, Excel and Word. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Linux, CLI
- **Repository:** https://github.com/soflutionltd/kilnshell
- **MCP Registry name:** com.soflution/kilnshell
- **Categories:** files and documents, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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