Provides tools for searching Lucide icons by keyword tags, returning best-matching icon names from Lucide's icon set.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@lucide-mcp find an icon for a user profile"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
lucide-mcp is a local Model Context Protocol (MCP) server for searching Lucide icon names by keyword tags.
It builds a local dictionary from Lucide icon metadata and exposes a search-icons tool over stdio.
Starts an MCP server over stdio.
Registers a search-icons tool.
Token matches keywords against icon names and tags by score.
Returns best-matching icon names.
Related MCP server: Icon MCP Server
Install the package.
pnpm add -g @vigi-p/lucide-mcpcodex mcp add <server-name> lucide-mcpIn the Agent panel, go to Settings-->Model Context Protocol (MCP) Servers->Add Server->Add Custom Server and add the following in the Local tab.
{
"<server-name>": {
"command": "lucide-mcp",
"args": [],
"env": {}
}
}Go to Cursor Settings->Tools & MCP->Add New MCP and add lucide-mcp to "mcpServers"
{
"mcpServers": {
"<server-name>": {
"command": "lucide-mcp",
"args": [],
"env": {}
},
// Other MCPs...
}
}Some prompt like Show me sample code for a navbar in astro with lucide icons. Use lucide-mcp.
lucide-mcp [options]
Options:
-h, --help Show this help message
-v, --version Print the current version
-c, --create-dictionary Create the icons dictionaryRemove the MCP from your IDE/agent. Eg: codex mcp remove <server-name>.
Remove the package.
pnpm remove -g @vigi-p/lucide-mcpDelete the ~/.lucide-mcp folder.
On first run (or with --refresh), the project fetches icon metadata from the Lucide repo's icons directory and writes a local dictionary to ~/.lucide-mcp/dictionary.json.
A temporary cache directory is used during fetch and then removed (~/.lucide-mcp/cache).
This project is licensed under the MIT License. See LICENSE.
See CONTRIBUTING.md for development workflow and PR guidelines.
Dependency licenses are tracked in THIRD_PARTY_LICENSES.md.
To regenerate the file after dependency changes:
pnpm licenses:updateThe generator script uses pnpm licenses list --json and writes a grouped package/license inventory.
Use this to search for a list of Lucide icons using tokenised matching. Each tool call should receive an array of sub-arrays of keywords as input to use in the search. Each sub-array should contain related keywords that convey a specific concept or visual meaning. Avoid the use of articles (e.g. 'a', 'the') and prepositions (e.g. 'in', 'on') in keywords if possible. The tool will return an array of sub-arrays of icon names such that each output sub-array contains icon names that match the search criteria for that specific input sub-array. Then, from the list of matches, select the most appropriate icon name.
Usage Example: To search for icons that represents the concepts "home page", "graph" and "warning", you might call:
search-icons({ keywords: [["home", "house"], ["graph", "chart"], ["danger"]] })This will return an output similar to:
{
"matches": [
[ "birdhouse", "house-heart", "house-plug", "house-plus", "house-wifi", "house", "map-pin-house" ],
[ "chart-area", "chart-bar-big", "chart-bar-decreasing", "chart-bar-increasing", "chart-bar-stacked", "chart-bar", "chart-candlestick" ],
[ "book-alert", "circle-alert", "cloud-alert", "file-exclamation-point", "message-circle-warning", "message-square-warning", "octagon-alert", "skull", "triangle-alert" ]
]
}How to use icon names in code:
With React: Convert the selected icon name to Pascal-case and import as a component from the 'lucide-react' package.
With React Native: Convert the selected icon name to Pascal-case and import as a component from the 'lucide-react-native' package.
With Astro: Convert the selected icon name to Pascal-case and import as a component from the '@lucide/astro' package.
Inputs: keywords (required). Returns: matches
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 1 tool
With only one tool, there is no ambiguity; the tool's purpose is clear and distinct.
Single tool named 'search-icons' follows a consistent verb_noun pattern (snake_case), with no inconsistency possible.
One tool is borderline thin; while it serves a focused purpose, many servers in similar domains have a few more tools (e.g., for metadata or browsing).
The server provides only search functionality; missing operations like listing all icons or retrieving a specific icon by name, which could be helpful.
Multilingual semantic SVG icon search with previews for AI coding agents. 20,000+ icons.
Search 324k icons or generate new ones in the Lucide grammar - grammar-locked lint+critique+repair
Icons for agentic development: search & fetch 366,000+ open-source icons as SVG/PNG. No API key.
Search open SVG icon packs and fetch exact SVG markup from coding agents through MCP.
