Everything Search MCP Server

![smithery badge](https://smithery.ai/badge/mcp-server-everything-search)

An MCP server that provides fast file searching capabilities across Windows, macOS, and Linux. On Windows, it uses the Everything SDK. On macOS, it uses the built-in mdfind command. On Linux, it uses the locate/plocate command.

Tools

search

Search for files and folders across your system. The search capabilities and syntax support vary by platform:

Windows: Full Everything SDK features (see syntax guide below)

macOS: Basic filename and content search using Spotlight database

Linux: Basic filename search using locate database

Parameters:

query (required): Search query string. See platform-specific notes below.

max_results (optional): Maximum number of results to return (default: 100, max: 1000)

match_path (optional): Match against full path instead of filename only (default: false)

match_case (optional): Enable case-sensitive search (default: false)

match_whole_word (optional): Match whole words only (default: false)

match_regex (optional): Enable regex search (default: false)

sort_by (optional): Sort order for results (default: 1). Available options:

Examples:

Response includes:

File/folder path

File size in bytes

Last modified date

Search Syntax Guide

For detailed information about the search syntax supported on each platform (Windows, macOS, and Linux), please see SEARCH_SYNTAX.md.

Prerequisites

Windows

Everything search utility:

Everything SDK:

Linux

Install and initialize the locate or plocate command:

After installation, update the database:

macOS

No additional setup required. The server uses the built-in mdfind command.

Installation

Installing via Smithery

To install Everything Search for Claude Desktop automatically via Smithery:

Using uv (recommended)

When using `uv` no specific installation is needed. We will use `uvx` to directly run mcp-server-everything-search.

Using PIP

Alternatively you can install mcp-server-everything-search via pip:

After installation, you can run it as a script using:

Configuration

Windows

The server requires the Everything SDK DLL to be available:

Environment variable:

Linux and macOS

No additional configuration required.

Usage with Claude Desktop

Add one of these configurations to your claude_desktop_config.json based on your platform:

Or if using pip installation:

Debugging

You can use the MCP inspector to debug the server. For uvx installations:

Or if you've installed the package in a specific directory or are developing on it:

To view server logs:

Linux/macOS:

Windows (PowerShell):

Development

If you are doing local development, there are two ways to test your changes:

Run the MCP inspector to test your changes. See Debugging for run instructions.

Test using the Claude desktop app. Add the following to your claude_desktop_config.json:

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Disclaimer

This project is not affiliated with, endorsed by, or sponsored by voidtools (the creators of Everything search utility). This is an independent project that utilizes the publicly available Everything SDK.