Kilnshell
Fast local MCP for shell, files, search, processes, PDF, Excel and Word
- 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.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"kilnshell": {
"command": "npx",
"args": [
"-y",
"https://github.com/Soflutionltd/kilnshell/releases/download/v1.0.5/kilnshell.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"kilnshell": {
"command": "npx",
"args": [
"-y",
"https://github.com/Soflutionltd/kilnshell/releases/download/v1.0.5/kilnshell.mcpb"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools