Mac File Search: Master Spotlight, mdfind and the Tools Beyond

Mac file search starts from a better place than Windows: Spotlight indexes file contents out of the box, Finder can save searches as living folders, and the whole index is queryable from Terminal. The catch is that Apple hides nearly all of this power behind an empty search box. Spotlight has a real query language — type filters, date operators, boolean logic — and macOS ships a command-line search engine (mdfind) most Mac users have never run.

This hub covers the full stack: Spotlight done properly, Finder smart folders, Terminal search, fixing a broken index, and the honest state of third-party Mac search tools — including where the Mac ecosystem is thinner than Windows', and what to do about it.

Press Cmd+Space and Spotlight opens. Most people type a word, scan the jumble of apps, web suggestions and files, and give up. The fix is telling Spotlight exactly what you mean with operators typed straight into the search field:

• kind: narrows by file type: kind:pdf, kind:image, kind:folder, kind:email, kind:presentation. So invoice kind:pdf skips every app and email called "invoice" and shows only PDFs.
• date: filters by date: date:today, date:yesterday, date:this week. Combine: report kind:pdf date:this month.
• name: matches the filename only, ignoring contents — crucial, because by default Spotlight matches text inside files, which is why a search for "budget" returns documents that merely mention the word.
• Exact phrases go in quotes: "quarterly board review" matches that phrase, not three scattered words.
• Boolean operators — AND, OR, NOT, in capitals — combine conditions: kind:pdf NOT name:draft, or tax OR invoice kind:pdf. A minus sign also works for exclusion: budget -2024.

Two settings worth checking in System Settings → Siri & Spotlight: untick result categories you never want (Siri Suggestions and websites top the list), and review the Spotlight Privacy exclusion list at the bottom — a folder in that list is completely invisible to every Spotlight-based tool, which is a common cause of "the file doesn't exist" mysteries.

Everything Spotlight knows is queryable from the command line with mdfind — same index, zero UI, scriptable output. The essentials:

# Anything matching a word (filenames AND contents)
mdfind "quarterly report"

# Filename-only search
mdfind -name budget.xlsx

# Limit the search to one folder tree
mdfind -onlyin ~/Documents "insurance claim"

# Live mode: keep printing new matches as they appear
mdfind -live "invoice"

The real power is raw metadata queries against Spotlight's attribute database. Every indexed file carries kMDItem attributes you can filter on:

# All PDFs modified in the last 7 days, under ~/Documents
mdfind -onlyin ~/Documents 'kMDItemContentType == "com.adobe.pdf" && kMDItemFSContentChangeDate >= $time.today(-7)'

# Images wider than 4000 pixels
mdfind 'kMDItemPixelWidth > 4000'

# Files authored by a specific person
mdfind 'kMDItemAuthors == "*Sarah*"'

To discover which attributes a file has, point mdls at it:

mdls ~/Documents/contract.pdf

That dumps every attribute Spotlight stored — content type, page count, authors, dates — each one a hook for an mdfind query. If terms like metadata or index need unpacking, our glossary defines them in plain English.

Honesty first: the Mac search-tool ecosystem is thinner than Windows'. There's no true Everything equivalent, because macOS doesn't expose a file-system catalog the way NTFS exposes its Master File Table — and most of the tools we review in depth on this site are Windows software. That said, the Mac options that exist are good:

Raycast and Alfred — launcher-style search. Both replace Cmd+Space with a faster, more controllable launcher whose file search queries the Spotlight index underneath. Raycast's core is free and feels modern; Alfred's serious file features (file actions, custom search scopes, workflows) need the paid Powerpack. If your complaint is Spotlight's interface rather than its index, either one solves it.

HoudahSpot — the power front-end. HoudahSpot (paid, with a trial) is the closest thing to a professional search application on the Mac: a column-based query builder over the Spotlight index with saved templates, result refinement, and every kMDItem attribute exposed in a GUI. It can only find what Spotlight has indexed — but it makes what Spotlight knows fully usable.

EasyFind — the no-index brute-forcer. Free and tiny, EasyFind ignores the Spotlight index and scans the file system directly. That makes it slow on a full disk — minutes, not milliseconds — but it finds what Spotlight hides: files in excluded locations, invisible files, package contents, things the index lost. Keep it around as your court of last resort.

Find Any File — fast attribute search. Another index-free scanner (small one-time price), searching by name, dates and size with a handy hierarchical results view. Like EasyFind, it trades speed for completeness and works on drives Spotlight won't touch.