The definitive MCP server for voidtools Everything - lightning-fast file search for AI agents.

PyPI Python License

Search millions of files in milliseconds. Built for Claude Code, Codex, Gemini, Kimi, Qwen, Cursor, Windsurf, and any MCP-compatible client.

Why This One?

Performance

@'
import os
import subprocess
import time
import 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

Via uv (recommended - no install needed)

uvx everything-mcp

Via pip

pip install everything-mcp

From source

git clone https://github.com/elis132/everything-mcp.git
cd everything-mcp
pip install -e ".[dev]"

Configuration

Environment Variables (Optional)

{
 "mcpServers": {
 "everything": {
 "command": "uvx",
 "args": ["everything-mcp"],
 "env": {
 "EVERYTHING_INSTANCE": "1.5a"
 }
 }
 }
}

Tools

1. everything_search - The Workhorse

*.py → All Python files
ext:py;js;ts → Multiple extensions
ext:py path:C:\Projects → Python files in Projects
size:>10mb → Larger than 10 MB
size:1kb..1mb → Between 1 KB and 1 MB
dm:today → Modified today
dm:last1week → Modified in the last week
dc:2024 → Created in 2024
"exact name.txt" → Exact filename match
project1 | project2 → OR search
!node_modules → Exclude term
ext:py !test !__pycache__ → Python, excluding tests
content:TODO → Files containing TODO (requires content indexing)
regex:^test_.*\.py$ → Regex search
parent:src ext:py → Python files in 'src' folders
dupe: → Duplicate filenames
empty: → Empty folders

2. everything_search_by_type - Category Search

3. everything_find_recent - What Changed?

4. everything_file_details - Deep Inspection

5. everything_count_stats - Quick Analytics

Examples

Troubleshooting

"es.exe not found"

"Everything IPC window not found"

"No results for valid queries"

Debugging

# View server logs
everything-mcp 2>everything-mcp.log
# MCP Inspector
npx @modelcontextprotocol/inspector uvx everything-mcp

Architecture

┌──────────────┐ MCP (stdio) ┌──────────────────┐
│ AI Agent │◄────────────────────►│ Everything MCP │
│ (Claude, │ │ Server │
│ Codex, etc) │ │ │
└──────────────┘ │ 5 Tools: │
 │ • search │
 │ • search_by_type│
 │ • find_recent │
 │ • file_details │
 │ • count_stats │
 └────────┬─────────┘
 │ async subprocess
 ▼
 ┌──────────────────┐
 │ es.exe │
 │ (CLI interface) │
 └────────┬─────────┘
 │ IPC / Named Pipes
 ▼
 ┌──────────────────┐
 │ Everything │
 │ Service │
 │ (voidtools) │
 │ │
 │ Real-time NTFS │
 │ file index │
 └──────────────────┘

Development

# Install with dev dependencies
pip install -e ".[dev]"
# Run tests
pytest
# Lint
ruff check src/ tests/

Contributing

License

Acknowledgments