Skip to main content

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

Metadata

Release files for mcp-everything-search 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-everything-search 0.3.0
File Size Uploaded
mcp_everything_search-0.3.0.tar.gz 8.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mcp-everything-search 0.3.0
File Interpreter ABI Platform
mcp_everything_search-0.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 17.6 kB

Release files / mcp_everything_search-0.3.0.tar.gz

Download URL mcp_everything_search-0.3.0.tar.gz
Size 8.4 kB
Tags Source
SHA-256 checksum
How to use checksums
31da2733999f281a920cb89e271c7e06090383dac0d7ca1d816b023ce6cbe49e
BLAKE2b-256 checksum
How to use checksums
99a97684df9ef210b19886f51b84b1c97de971ae4f1ce680b1c2530d1c8aab64
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.17 {"installer":{"name":"uv","version":"0.9.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / mcp_everything_search-0.3.0-py3-none-any.whl

Download URL mcp_everything_search-0.3.0-py3-none-any.whl
Size 9.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c2b699d219b359cbb4ab399a8fbab38207aa2ae5f0fdf971743c74a007dddfd7
BLAKE2b-256 checksum
How to use checksums
07d7e16b6c4b813a3a20b5b1e8ac74089e684e579258802baacd369cc741c104
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.17 {"installer":{"name":"uv","version":"0.9.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.3.0 This release

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page