Everything Search MCP Server

When using the Everything SDK on Windows, you can use advanced operators, wildcards, and specialized functions to refine your searches.

Basic Operators

• space: AND operator
• |: OR operator
• !: NOT operator
• < >: Grouping
• " ": Exact phrase

Wildcards

• *: Zero or more characters
• ?: Exactly one character Note: Wildcards match the whole filename by default unless 'Match whole filename' is disabled.

Function Syntax

Use these comparison operators with functions:

• function:value (Equal to)
• function:<=value (Less than or equal)
• function:<value (Less than)
• function:=value (Equal to)
• function:>value (Greater than)
• function:>=value (Greater than or equal)
• function:start..end (Range)
• function:start-end (Range)

# Example 1: Find Python files modified today
ext:py datemodified:today

# Example 2: Find large video files
ext:mp4|mkv|avi size:>1gb

# Example 3: Find files in specific folder
path:C:\Projects *.js

macOS uses Spotlight's mdfind command. Searches can target metadata attributes, content types, and dates.

Command Options

• -live: Live updates to results
• -count: Show only the number of matches
• -onlyin <directory>: Limit search to a specific directory
• -literal: Treat query as literal text
• -interpret: Interpret query as if typed in Spotlight menu

Basic Search & Operators

• Simple text searches match any metadata attribute.
• Multiple words are treated as AND conditions.
• | (OR): Match either word (e.g., "image|photo")
• - (NOT): Exclude matches (e.g., -screenshot)
• =, == (equal)
• != (not equal)
• <, > (less/greater than)
• <=, >= (less/greater than or equal)
• Use parentheses () to group expressions.

Value Comparison Modifiers

Use brackets with modifiers:

• [c]: Case-insensitive comparison
• [d]: Diacritical marks insensitive
• [cd]: Both case and diacritical insensitive

# Example 1: Find images modified yesterday
kind:image date:yesterday

# Example 2: Find documents by author (case-insensitive)
kMDItemAuthors ==[c] "John Doe"

# Example 3: Find files in specific directory
mdfind -onlyin ~/Documents "query"

# Example 4: Complex metadata search
kMDItemContentTypeTree = "public.image" && kMDItemUserTags = "vacation" && kMDItemFSContentChangeDate >= $time.this_month()

Add the server configuration to your claude_desktop_config.json file based on your OS and installation method.

Windows (using uvx)

"mcpServers": {
  "everything-search": {
    "command": "uvx",
    "args": ["mcp-server-everything-search"],
    "env": {
      "EVERYTHING_SDK_PATH": "path/to/Everything-SDK/dll/Everything64.dll"
    }
  }
}

Windows (using pip)

"mcpServers": {
  "everything-search": {
    "command": "python",
    "args": ["-m", "mcp_server_everything_search"],
    "env": {
      "EVERYTHING_SDK_PATH": "path/to/Everything-SDK/dll/Everything64.dll"
    }
  }
}

Linux and macOS (using uvx)

"mcpServers": {
  "everything-search": {
    "command": "uvx",
    "args": ["mcp-server-everything-search"]
  }
}

Linux and macOS (using pip)

"mcpServers": {
  "everything-search": {
    "command": "python",
    "args": ["-m", "mcp_server_everything_search"]
  }
}

The search tool allows for fast file searching across different operating systems.

Platform-specific capabilities:

• Windows: Full support for Everything SDK features.
• macOS: Basic filename and content search via Spotlight (mdfind).
• Linux: Basic filename search via locate/plocate database.

Parameters:

• query (required): The search string.
• max_results (optional): Max results to return (default: 100, max: 1000).
• match_path (optional): Match against full path instead of filename (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 (default: 1).

Sort Options (sort_by):

• 1: Filename (A to Z)
• 2: Filename (Z to A)
• 3: Path (A to Z)
• 4: Path (Z to A)
• 5: Size (smallest first)
• 6: Size (largest first)
• 7: Extension (A to Z)
• 8: Extension (Z to A)
• 11: Creation date (oldest first)
• 12: Creation date (newest first)
• 13: Modification date (oldest first)
• 14: Modification date (newest first)

Response Format: Each result includes the file/folder path, file size in bytes, and the last modified date.

{
  "query": "*.py",
  "max_results": 50,
  "sort_by": 6
}