mcp-everything-search 0.2.1

An MCP server for Everything (voidtools) file search

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

1. Windows - Everything only runs on Windows
2. Everything must be installed and running
3. 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, 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

• Everything by voidtools
• Model Context Protocol by Anthropic