Skip to main content
Glama
mcp-everything-search

mcp-everything-search

by essovius

Everything MCP Server

PyPI version License: MIT

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

  1. Windows - Everything only runs on Windows

  2. Everything must be installed and running

  3. es.exe (Everything command-line) installed

Installation

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

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

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, extension

  • date-modified, date-created, date-accessed

  • Add -descending for 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

Available Tools

16 tools
export_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

    B3.4/5.0

    Scored across 16 tools

    Disambiguation4/5

    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.

    Naming Consistency3/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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 npm
      15
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Integrates 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.
      1
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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 PyPI
      4
      MIT