Skip to main content
Glama
essovius

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

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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/essovius/mcp-everything-search'

If you have feedback or need assistance with the MCP directory API, please join our Discord server