Everything MCP Server
An MCP (Model Context Protocol) server that integrates Everything file search with Claude Desktop. Search your entire Windows filesystem instantly from Claude.
Features
- ⚡ Instant search - Leverages Everything's lightning-fast file indexing
- 🔍 Multiple search modes - Basic, filtered, regex, type-based, attribute-based
- 📁 Folder operations - Search within specific paths, find empty folders
- 📊 Statistics - Get file counts and total sizes without listing files
- 🕐 Recent files - Find recently modified files
- 📋 Duplicate finder - Locate files with the same name
- 💾 Export - Save results to txt, csv, json, and more
Prerequisites
- Windows - Everything only runs on Windows
- Everything must be installed and running
- es.exe (Everything command-line) installed
- Install from: https://github.com/voidtools/es
- Must be in
%LOCALAPPDATA%\Microsoft\WindowsApps
Installation
Using uvx (recommended)
uvx mcp-everything-search
Using pip
pip install mcp-everything-search
Configuration
Add this to your Claude Desktop config file:
Location: %APPDATA%\Claude\claude_desktop_config.json
Using uvx
{
"mcpServers": {
"everything-search": {
"command": "uvx",
"args": ["mcp-everything-search"]
}
}
}
Using pip
{
"mcpServers": {
"everything-search": {
"command": "python",
"args": ["-m", "mcp_everything_search"]
}
}
}
Everything 1.5 Alpha Users
If you're using Everything 1.5 alpha, add the EVERYTHING_INSTANCE environment variable:
{
"mcpServers": {
"everything-search": {
"command": "uvx",
"args": ["mcp-everything-search"],
"env": {
"EVERYTHING_INSTANCE": "1.5a"
}
}
}
}
Then restart Claude Desktop.
Available Tools
Basic Search
| Tool | Description |
|---|---|
search_files |
Basic file search with wildcards (*, ?), sorting options |
search_with_filters |
Search with extension, size, path filters, files/folders only |
search_regex |
Search using regular expressions |
Specialized Search
| Tool | Description |
|---|---|
search_by_type |
Search by category: audio, video, image, document, executable, compressed, code |
search_folders |
Find only directories |
search_recent_files |
Find recently modified files |
search_duplicates |
Find files with the same name |
search_by_attributes |
Filter by hidden, system, read-only, compressed, encrypted |
search_empty_folders |
Find empty directories |
search_large_files |
Find files over a specified size |
Utilities
| Tool | Description |
|---|---|
search_with_details |
Search with detailed output (size, dates) |
get_result_count |
Get count of matches without listing (fast) |
get_total_size |
Get total size of all matching files |
open_file_location |
Open containing folder in Explorer |
get_file_info |
Get file size, dates, and details |
export_search_results |
Export to txt, csv, json, m3u, m3u8, tsv, efu |
Example Queries
Ask Claude things like:
- "Find all Python files in D:\Projects"
- "Search for PDF files larger than 10mb"
- "Find images modified in the last 3 days"
- "Look for duplicate files named config.json"
- "Find all video files in my Downloads folder"
- "Search for files matching regex
test_.*\.py$" - "Find empty folders in D:\Archive"
- "What's the total size of all MP3 files?"
- "How many JavaScript files are in this project?"
- "Find hidden files in C:\Windows"
- "Export all log files to a CSV"
Sort Options
Many tools support sort_by parameter:
name,path,size,extensiondate-modified,date-created,date-accessed- Add
-descendingfor reverse order (e.g.,size-descending)
Development
# Clone the repo
git clone https://github.com/essovius/mcp-everything-search.git
cd mcp-everything-search
# Create virtual environment
python -m venv venv
.\venv\Scripts\activate
# Install in development mode
pip install -e .
# Run the server
python -m mcp_everything_search
License
MIT License - see LICENSE for details.
Acknowledgments
- Everything by voidtools
- Model Context Protocol by Anthropic
Metadata
Release files for mcp-everything-search 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mcp_everything_search-0.3.0.tar.gz | 8.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mcp_everything_search-0.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 17.6 kB
Release files / mcp_everything_search-0.3.0.tar.gz
| Download URL | mcp_everything_search-0.3.0.tar.gz |
|---|---|
| Size | 8.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
31da2733999f281a920cb89e271c7e06090383dac0d7ca1d816b023ce6cbe49e
|
|
BLAKE2b-256 checksum How to use checksums |
99a97684df9ef210b19886f51b84b1c97de971ae4f1ce680b1c2530d1c8aab64
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.17 {"installer":{"name":"uv","version":"0.9.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / mcp_everything_search-0.3.0-py3-none-any.whl
| Download URL | mcp_everything_search-0.3.0-py3-none-any.whl |
|---|---|
| Size | 9.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c2b699d219b359cbb4ab399a8fbab38207aa2ae5f0fdf971743c74a007dddfd7
|
|
BLAKE2b-256 checksum How to use checksums |
07d7e16b6c4b813a3a20b5b1e8ac74089e684e579258802baacd369cc741c104
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.17 {"installer":{"name":"uv","version":"0.9.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|