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