⚡ Everything MCP
MCP server for voidtools Everything - search millions of Windows files in milliseconds from any AI agent.
Quick start
/plugin marketplace add elis132/everything-mcp
/plugin install everything-mcp@everything-mcp
That's it for Claude Code - the plugin bundles the MCP server and a skill that teaches the query syntax. For every other client, see Installation below.
Why this one
| everything-mcp (this) | mamertofabian (342⭐) | Josephur (26⭐) | essovius |
|---|
| Tools | 5 | 1 | 1 | 16 |
| Setup | Auto-detects es.exe | Manual SDK DLL path | Manual HTTP server + host/port | Manual es.exe in PATH |
| Everything 1.5 | Auto-detects instance | Not supported | Untested | Manual flag |
| Talks to Everything via | es.exe subprocess | Everything SDK (DLL) | Everything's HTTP server plugin (unauthenticated) | es.exe subprocess |
| Tests / CI | pytest, GitHub Actions | None visible | None visible | None visible |
Performance
es.exe (Everything's real-time NTFS index) vs. a naive filesystem walk, same query:
- everything-mcp: 220 ms avg (5 runs)
- Naive walk of
C:\: 66,539 ms
- ~300x faster
Reproduce this benchmark
@'
import os, subprocess, time, statistics
ES = os.path.expandvars(r"%LOCALAPPDATA%\Everything\es.exe")
QUERY = "everything.exe"
es_runs = []
for _ in range(5):
t0 = time.perf_counter()
subprocess.run([ES, "-n", "100", QUERY], capture_output=True, text=True)
es_runs.append((time.perf_counter() - t0) * 1000)
t0 = time.perf_counter()
matches = []
for dirpath, _, filenames in os.walk(r"C:\\"):
for name in filenames:
if name.lower() == QUERY:
matches.append(os.path.join(dirpath, name))
walk_ms = (time.perf_counter() - t0) * 1000
es_avg = statistics.mean(es_runs)
print("ES avg ms:", round(es_avg, 2))
print("Walk ms:", round(walk_ms, 2))
print("Speedup x:", round(walk_ms / es_avg, 1))
print("Matches:", len(matches))
'@ | python -
Installation
Prerequisites
- Windows with Everything installed and running
- es.exe (Everything's command-line interface) - included with Everything 1.5 alpha, or install separately:
winget install voidtools.Everything.Cli
scoop install everything-cli
choco install es
- or download from github.com/voidtools/es and place it in your PATH
- Python 3.10+ or uv
Run the server
uvx everything-mcp # recommended, no install needed
pip install everything-mcp # or via pip
From source:
git clone https://github.com/elis132/everything-mcp.git
cd everything-mcp && pip install -e ".[dev]"
Add it to your client
Every client below uses the same MCP server definition:
{
"mcpServers": {
"everything": {
"command": "uvx",
"args": ["everything-mcp"]
}
}
}
| Client | How to add it |
|---|
| Claude Code | /plugin install everything-mcp@everything-mcp (see Quick start), or claude mcp add everything -- uvx everything-mcp |
| Claude Desktop | Paste the JSON above into %APPDATA%\Claude\claude_desktop_config.json |
| Codex CLI | codex mcp add everything -- uvx everything-mcp |
| Gemini CLI | gemini mcp add -s user everything uvx everything-mcp |
| Kimi CLI | kimi mcp add --transport stdio everything -- uvx everything-mcp |
| Qwen CLI | qwen mcp add -s user everything uvx everything-mcp |
| Cursor | Paste the JSON above into Cursor's MCP settings UI |
| Windsurf | Paste the JSON above into %USERPROFILE%\.codeium\windsurf\mcp_config.json |
| Any other MCP client | Use the JSON above verbatim |
Using pip instead of uvx
{ "mcpServers": { "everything": { "command": "everything-mcp" } } }
Or with explicit Python: {"command": "python", "args": ["-m", "everything_mcp"]}
Environment variables (optional)
Everything MCP auto-detects your setup, but you can override: