Everything Search MCP

io.github.EcRal5tPublished by GitHub account EcRal5tv0.1.0Updated Oct 31, 2026

Fast file search on Windows with Everything. Find files, browse folders, and compare sizes.

VerifiedSTDIODesktop onlyFiles & StorageDeveloper Tools

Overview

AI-generated overview

Lets an assistant search Windows drives through the Everything index: find files and folders by name, path, type, size or date, browse folders and compare…

What you can do
  • Search indexed drives for files and folders by name, path, type, size or date, with optional regex, sorting and pagination
  • Browse the direct children of a folder or search recursively under a root path
  • Count matches and total matched bytes, or return extra metadata such as size, timestamps, attributes and run count
  • Run up to eight queries in one request and check backend connection, Everything version, selected instance and index readiness
When to use it
Useful on Windows when the assistant needs to locate files or folders on local or indexed drives, investigate large files, find project artifacts, or compare folder sizes without the user describing the directory tree by hand.
Requirements
Windows (x64, x86, ARM64, ARM) with Everything 1.4.1+ or 1.5 Alpha installed and running; Node.js v22.0.0 or newer; the npm package runs locally over stdio, typically launched through cmd.exe with npx. Optional environment variables select a custom instance (EVERYTHING_INSTANCE), an Everything HTTP service (EVERYTHING_URL with EVERYTHING_USERNAME and EVERYTHING_PASSWORD), result caps, output budget, timeout and es.exe path.
Before you install
Both tools are described as read-only, but search results expose file paths, names, sizes and timestamps from the user's drives to the assistant and its model provider. If EVERYTHING_URL is set, credentials are supplied through EVERYTHING_USERNAME and EVERYTHING_PASSWORD; keep them out of shared configuration files. The HTTP backend supports fewer sort fields and metadata than local IPC.

Installation

In SourceWeft

  1. Open Everything Search MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Everything Search MCP

简体中文

Search Windows files from your AI assistant using Everything.

Find files across indexed drives by name, path, type, size, or date. Browse folders, compare their sizes, and get counts or total file sizes in a single request. Searches use Everything's existing index, with paginated results and optional metadata.

Prerequisites

  • OS: Windows (x64, x86, ARM64, ARM)
  • Node.js: v22.0.0 or newer
  • Everything: Everything 1.4.1+ or 1.5 Alpha installed and running.

The ES helper is included. The server automatically checks the default Everything instance, 1.5a, and 1.5 and connects through local IPC.

Installation & Configuration

On Windows, launch npx through cmd.exe as shown below. Choose your client, add the configuration, then reload its MCP connections. (DeepSeek Harness is the exception: it spawns the command directly, so plain npx works — see its section below.)

[Install in Cursor]

OpenAI Codex

Add to your Codex configuration file (%USERPROFILE%/.codex/config.toml or project-level .codex/config.toml):

toml
[mcp_servers.everything]command = "cmd.exe"args = ["/d", "/c", "npx", "-y", "everything-mcp-server"]

Or add via Codex CLI:

powershell
codex mcp add everything -- cmd.exe /d /c npx -y everything-mcp-server
OpenCode

Add to your project's opencode.json:

json
{  "$schema": "https://opencode.ai/config.json",  "mcp": {    "everything": {      "type": "local",      "command": ["cmd.exe", "/d", "/c", "npx", "-y", "everything-mcp-server"]    }  }}

Or run the OpenCode setup wizard and enter the command above:

powershell
opencode mcp add
DeepSeek Harness

Install the plugin, then restart the profile:

powershell
dsh plugin --profile <profile> add dsh-everything-mcp

Or install straight from this repository:

powershell
dsh plugin --profile <profile> add github:EcRal5t/everything-search-mcp#path:/plugins/dsh-everything-mcp

The tools appear as mcp__everything__search and mcp__everything__status. To wire it by hand instead, add this row to the profile's cordis.patch.yml:

yaml
- insert:    - id: mcp-everything      name: '@deepseek-ai/dsh-mcp-client'      config:        serverName: everything        transport: stdio        command: npx        args: ['-y', 'everything-mcp-server']

DSH spawns commands directly, so no cmd.exe wrapper is needed. See plugins/dsh-everything-mcp for the bundle itself.

Claude Desktop and other MCP clients

Add to your MCP client configuration (e.g. claude_desktop_config.json):

json
{  "mcpServers": {    "everything": {      "command": "cmd.exe",      "args": ["/d", "/c", "npx", "-y", "everything-mcp-server"]    }  }}

VS Code uses servers as the top-level key.

What to ask

After connecting, ask your assistant to use Everything for tasks such as:

  • Locate a missing file: “Find quarterly-report PDFs modified last month across my indexed drives.”
  • Investigate large files: “Show the ten largest log files or archives over 1 GB on C:, including their paths and sizes.”
  • Find project artifacts: “Find folders named node_modules or target under D:/Projects and tell me how many there are.”
  • Compare folder sizes: “Compare the sizes of the folders directly inside D:/Projects.”

Tools

Both tools are read-only.

ToolPurpose
searchFind paths, browse folders, count matches, and retrieve sizes or other indexed metadata.
statusCheck the connection, selected Everything instance, and version.

Connection settings

Default settings cover common local installations. Use EVERYTHING_INSTANCE for a custom instance name. Setting EVERYTHING_URL selects an Everything HTTP service; credentials go in EVERYTHING_USERNAME and EVERYTHING_PASSWORD when needed.

All environment variables
VariableDefaultDescription
EVERYTHING_INSTANCEauto-detectProbes the default instance, 1.5a, and 1.5. Set this for a custom instance; "" selects the default instance.
EVERYTHING_URL""Everything HTTP server URL (e.g. http://127.0.0.1:17603/). When set, uses HTTP transport instead of IPC.
EVERYTHING_USERNAME""Basic auth username for HTTP server.
EVERYTHING_PASSWORD""Basic auth password for HTTP server.
EVERYTHING_MAX_RESULTS1000Row cap for each query and the whole batch (1–1000).
EVERYTHING_OUTPUT_BYTES16384Maximum output size budget per tool call (4096–65536).
EVERYTHING_TIMEOUT_MS15000Query timeout in milliseconds (100–120000).
EVERYTHING_ES_PATHbundledCustom path to es.exe.

CLI & Diagnostics

Test your Everything installation and backend connection:

powershell
npx -y everything-mcp-server doctor

Run queries from the command line:

powershell
npx -y everything-mcp-server search '{"requests": [{"query": "ext:pdf", "count": 5}]}'

Tool reference

Parameters and result format

search

Search, browse directories, count items, and retrieve indexed metadata.

Pass 1–8 queries in the required requests array:

json
{"requests": [{"query": "ext:pdf", "count": 5}]}

Parameters for each query:

ParameterTypeDefaultDescription
querystring""Everything search query (e.g. *.pdf, size:>100mb, ext:ts;js).
rootstringoptionalDirectory to search within (e.g. D:/Projects). Omitted for global search.
recursivebooleantrueWhen root is set: true searches descendants; false lists direct children.
kindstring"any"Filter entry type: "any", "file", or "folder".
regexbooleanfalseTreat query as a regular expression.
countnumber20Maximum rows to return (max 1000). Use 0 to count matches; add kind:"file" and fields:["size"] to get total_size_bytes.
offsetnumber0Zero-based pagination offset.
sortstring"path"Sort field: path, name, size, extension, date_modified, date_created, date_accessed, attributes, run_count.
ascendingbooleantrueSort ascending (true) or descending (false).
fieldsstring[][]Additional columns: size, date_modified, date_created, date_accessed, attributes, run_count.

IPC provides all listed fields and sorts. HTTP sorts by name, path, size, or modified time; it provides size and modified-time fields, with other metadata depending on the service.

Output Format:

Results label columns once, followed by row arrays:

json
{  "results": [    {      "base": "D:/Projects",      "total": 42,      "next_offset": 2,      "columns": ["path", "type", "size_bytes"],      "rows": [        ["src/index.ts", "file", 1024],        ["package.json", "file", 512]      ],      "size_basis": "indexed_logical"    }  ]}

Combine base with relative paths in rows to obtain full file paths. File and folder sizes use logical byte counts from Everything's index.

status

Check backend connectivity, Everything version, selected instance, and index status.

Parameters:

  • verbose (boolean, default false): Include total indexed items and limits.

Local Development

powershell
git clone https://github.com/EcRal5t/everything-search-mcp.gitcd everything-search-mcpnpm installnpm test

To configure an MCP client with a local checkout:

json
{  "mcpServers": {    "everything": {      "command": "node",      "args": ["D:/path/to/everything-search-mcp/src/cli.js"]    }  }}

License

MIT. Bundled es.exe is also MIT licensed by voidtools. See THIRD_PARTY_NOTICES.md.

Source: README.md at commit 8292039

Tools

2

everything_status

Check connection status, selected instance, version, and index readiness.

Parametersverbose

Version history

1
  1. v0.1.0LatestOct 31, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts