Lupa — local file search for your Mac

Search your Mac's files by name and by text inside documents.

Connector by paeyoungpark-web · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)

Chalk Labs

Need help deploying Lupa — local file search for your Mac?

Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.

Book a call

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/paeyoungpark-web-lupa-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

Search your Mac's files by name and by text inside documents. Local index, Korean-aware.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Nov 1, 2026.

Tools: 2 read · 0 write · 0 deleteRead-only
Secrets: None asked for
Install scripts: None found
Runs as: Node.js package

Tools by what they do 2

Read from the source code; the running server may list different tools.

Read 2 · Look things up without changing anything.

lupa_read
lupa_search

Network hosts it talks to 2

github.com · found in code
lupa.kr · found in code

Files it touches

/opt/homebrew/bin/lupa-search
Your home directory (~)
Any path the agent passes to its tools

Tools (2)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

lupa_readRead a file's indexed text
Return the text Lupa already extracted from a file, without opening the file itself. Works for PDF, Word, Excel, PowerPoint, Hangul HWP/HWPX and scanned documents that were OCR'd. Use this after lupa_search when you need the actual content — it is far cheaper than reading the original file, and it works even for formats you cannot parse. Note: only the beginning of each document is indexed, so very long files are truncated. If the file has no indexed text (image-only, password-protected, or not yet content-indexed), this reports that instead.
lupa_searchSearch files on this Mac
Find files on this Mac by file name AND by what is written inside documents (PDF, Word, Excel, PowerPoint, Hangul HWP/HWPX, plain text, and scanned PDFs read with OCR). Searches Lupa's local index, so it answers in ~30ms and never touches the network. Prefer this over find/grep/mdfind for locating files. Returns ranked paths with a matching snippet. To read a file's text afterwards, use lupa_read — it returns the indexed text without opening the file. Query syntax (combine freely; more conditions = sharper results): word1 word2 files matching ALL words rank first (grouped by match cou…

Signals

Stars: 0
Forks: 0
Open issues: 0
Last commit: Oct 14, 2026 (22 days ago)
Last release: Sep 21, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name: io.github.paeyoungpark-web/lupa-mcp
Version: 0.2.0
Auth: No auth
Packages: npm lupa-mcp
License: MIT
Repository: github.com/paeyoungpark-web/lupa-mcp
Website: lupa.kr/agents.html
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: Official MCP Registry github-graphql

Done for you

Rather not set it up yourself?

Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.

See how we build AI agents →Read the case studies

Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.

launches shipped: 50+; launches shipped
media placements: 500+; media placements
founders on every account: 2; founders on every account

Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block

Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.

Get Lupa — local file search for your Mac running in your business

Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.

Need help deploying Lupa — local file search for your Mac?

Call Get help

Cite this page

Lupa — local file search for your Mac MCP server. Agent Mart. https://agentmart.dev/connectors/paeyoungpark-web-lupa-mcp (last updated 2026-10-24)