mcp-everything-search
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-everything-search Find all Python files in D:\Projects"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Related MCP server: Everything Search MCP Server
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-searchUsing pip
pip install mcp-everything-searchConfiguration
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 |
| Basic file search with wildcards ( |
| Search with extension, size, path filters, files/folders only |
| Search using regular expressions |
Specialized Search
Tool | Description |
| Search by category: audio, video, image, document, executable, compressed, code |
| Find only directories |
| Find recently modified files |
| Find files with the same name |
| Filter by hidden, system, read-only, compressed, encrypted |
| Find empty directories |
| Find files over a specified size |
Utilities
Tool | Description |
| Search with detailed output (size, dates) |
| Get count of matches without listing (fast) |
| Get total size of all matching files |
| Open containing folder in Explorer |
| Get file size, dates, and details |
| 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-accessedAdd
-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_searchLicense
MIT License - see LICENSE for details.
Acknowledgments
Everything by voidtools
Model Context Protocol by Anthropic
Available Tools
16 toolsexport_search_resultsC
Export search results to a file.
Args: query: Search query output_file: Output file path (e.g., "C:/results.txt") format: Export format: txt, csv, json, m3u, m3u8, tsv, efu folder_path: Limit search to specific folder (optional) extension: File extension filter (optional) max_results: Maximum number of results (default 1000) include_size: Include file sizes in export include_dates: Include dates (created, modified) in export
Inputs: query (required), output_file (required), format, folder_path, +4 more. Returns: result
get_file_infoC
Get detailed information about a file.
Args: file_path: Full path to the file
Inputs: file_path (required). Returns: result
get_result_countA
Get the count of matching files without listing them (fast).
Args: query: Search query folder_path: Limit search to specific folder (optional) extension: File extension filter (optional)
Inputs: query (required), folder_path, extension. Returns: result
get_total_sizeB
Get the total size of all matching files.
Args: query: Search query folder_path: Limit search to specific folder (optional) extension: File extension filter (optional)
Inputs: query (required), folder_path, extension. Returns: result
open_file_locationA
Open the folder containing a file in Windows Explorer.
Args: file_path: Full path to the file
Inputs: file_path (required). Returns: result
search_by_attributesB
Search files by Windows file attributes.
Args: query: Additional search query (optional) hidden: Find hidden files system: Find system files read_only: Find read-only files compressed: Find compressed files encrypted: Find encrypted files folder_path: Limit search to specific folder (optional) max_results: Maximum number of results (default 50)
Inputs: query, hidden, system, read_only, +4 more. Returns: result
search_by_typeB
Search for specific file types.
Args: file_type: Type: audio, video, image, document, executable, compressed, code query: Additional search query (optional) folder_path: Limit search to specific folder path (optional) max_results: Maximum number of results (default 50)
Inputs: file_type (required), query, folder_path, max_results. Returns: result
search_duplicatesA
Find files with the same name (potential duplicates).
Args: filename: Exact filename to search for folder_path: Limit search to specific folder (optional) max_results: Maximum number of results (default 50)
Inputs: filename (required), folder_path, max_results. Returns: result
search_empty_foldersB
Find empty folders.
Args: folder_path: Limit search to specific folder (optional) max_results: Maximum number of results (default 100)
Inputs: folder_path, max_results. Returns: result
search_filesB
Search for files and folders using Everything.
Args: query: Search query (supports wildcards * and ?) max_results: Maximum number of results (default 50) match_case: Enable case-sensitive search match_whole_word: Match whole words only match_path: Search in full path instead of filename only sort_by: Sort by: name, path, size, extension, date-modified, date-created, date-accessed
Inputs: query (required), max_results, match_case, match_whole_word, +2 more. Returns: result
search_foldersB
Search for folders/directories only.
Args: query: Search query (optional) folder_path: Limit search to specific parent folder (optional) max_results: Maximum number of results (default 50) sort_by: Sort by: name, path, date-modified, date-created
Inputs: query, folder_path, max_results, sort_by. Returns: result
search_large_filesA
Find large files.
Args: min_size: Minimum file size (e.g., "100mb", "1gb", "500kb"). Default: 100mb folder_path: Limit search to specific folder (optional) extension: File extension filter (optional) max_results: Maximum number of results (default 50)
Inputs: min_size, folder_path, extension, max_results. Returns: result
search_recent_filesB
Search for recently modified files.
Args: days: Files modified within this many days (default 7) query: Additional search query (optional) folder_path: Limit search to specific folder (optional) max_results: Maximum number of results (default 50) files_only: Return only files, not folders (default True)
Inputs: days, query, folder_path, max_results, +1 more. Returns: result
search_regexC
Search using regular expressions.
Args: pattern: Regular expression pattern folder_path: Limit search to specific folder path (optional) max_results: Maximum number of results (default 50) match_case: Enable case-sensitive search
Inputs: pattern (required), folder_path, max_results, match_case. Returns: result
search_with_detailsB
Search files and return detailed information (name, path, size, dates).
Args: query: Search query folder_path: Limit search to specific folder (optional) extension: File extension filter (optional) max_results: Maximum number of results (default 50) sort_by: Sort by: name, path, size, date-modified[-descending], date-created[-descending] files_only: Return only files folders_only: Return only folders
Inputs: query (required), folder_path, extension, max_results, +3 more. Returns: result
search_with_filtersB
Search files with advanced filters.
Args: query: Search query (optional if using other filters) extension: File extension filter (e.g., "py", "txt", "pdf") folder_path: Limit search to specific folder path min_size: Minimum file size (e.g., "1mb", "500kb", "1gb") max_size: Maximum file size (e.g., "10mb", "1gb") max_results: Maximum number of results (default 50) match_case: Enable case-sensitive search files_only: Return only files, not folders folders_only: Return only folders, not files sort_by: Sort by: name, path, size, extension, date-modified, date-created
Inputs: query, extension, folder_path, min_size, +6 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
Most tools have distinct purposes (e.g., search_files vs search_by_type vs search_regex), but some overlap exists between general search tools like search_files, search_with_details, and search_with_filters. Descriptions help, but an agent might occasionally misselect between them.
The naming pattern is mixed: some tools use 'search_', others use 'get_', 'open_', or 'export_'. Within the search subgroup it's consistent, but overall it's a mix of conventions that could be more uniform.
16 tools is well-scoped for a file search utility. Each tool adds value for specific search subtasks (duplicates, large files, regex, etc.) without being excessive.
The tool set covers most common search operations (by query, type, attributes, size, date, regex, duplicates, empty folders, etc.) plus export and file info. Minor gaps like search by content or index management are acceptable for the domain.
Maintenance
Related MCP Connectors
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
Work on your own computers from Claude or ChatGPT: run commands, edit and search files.
Give Claude only the Google Drive files you choose. Every action logged.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables instant file and folder searching on Windows using Everything's blazing-fast search engine, supporting powerful search syntax including wildcards, regex, size filters, date filters, and comprehensive file information retrieval.35 npm15MIT
- AlicenseNot gradedqualityDmaintenanceIntegrates with Everything Search Engine to provide lightning-fast file search capabilities across Windows systems using natural language queries and advanced filtering options through MCP-compatible applications.1ISC
- AlicenseBqualityDmaintenanceIntegrates voidtools Everything search engine with AI assistants to provide lightning-fast file search, GitHub integration, intent-based code research, and spec-driven development tools for Windows.5146 npm2MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search local files on Windows using the Everything search engine, supporting basic and complex file searches with filters like date, size, media type, and document type.15 PyPI4MIT