What is the Lucide Icons MCP server?
This MCP server, built with Bun and the MCP TypeScript SDK, exposes the Lucide icon set as tools. An AI agent can search icons by name or category, fuzzy match names, list categories and fetch a React usage example for any exact icon name.
Lucide is an open-source icon toolkit that the README describes as consistent and community made, with over 1,500 icons. This server wraps the Lucide React set so a model can look icons up instead of guessing names.
It runs in two modes. Stdio mode suits desktop MCP clients, while HTTP mode starts a local server on port 3000 by default. A crawler in the repo refreshes icon data from the Lucide website.
What changes in your agent's output
- The agent searches real icon names, so it stops importing components that do not exist.
- Category tools expose groups such as Arrows, Charts, Design and Navigation, which helps when you only know the idea.
- Exact-name lookup returns a JSX example with the import from
lucide-react. - Fuzzy search tolerates typos and near names.
Connect it to a client
The README recommends the npx route in stdio mode. Add the entry to your desktop client's config, restart, and the lucide-icons tools show up in its tools panel.
Who this server is for
Best for
- React projects that already use Lucide and want the agent to stay inside that single set.
- Design system maintainers keeping icon usage consistent across components, alongside the shadcn MCP server.
- Anyone who wants a small, single-purpose server instead of a catalog of many libraries.
Not for
- Projects that need several icon libraries in one search. Unicon MCP covers nine libraries.
- Writing the icon into your files. This server returns information and examples only.
- Frameworks other than React, since the examples are React and JSX.
Use it with UiChemy
This server is for choosing icons in React code. On WordPress, UiChemy is the route: Figma to WordPress converts a design, and Composer edits the page in Elementor or Gutenberg. Click Get Started on uichemy.com.
Connect Lucide Icons MCP Server: Search Lucide Icons With an AI Agent to your AI client
npx lucide-icons-mcp --stdioPick a mode
Use
--stdiofor desktop clients. Runnpx lucide-icons-mcpwith no flag to start the HTTP server on port 3000.Open your client config
The README example edits the Claude Desktop config file. Other MCP clients take the same command and args in their own config.
Add the entry
Paste the JSON above into the
mcpServerssection and save.Restart and check
Restart the client. The lucide-icons server should appear in its tools panel.
Optional: run from source
Clone the repo, run
bun installandbun run build, then point the config atbuild/entry.jswith--stdio.
Client configuration
{
"mcpServers": {
"lucide-icons": {
"command": "npx",
"args": ["lucide-icons-mcp", "--stdio"]
}
}
}Endpoints and ports
npx lucide-icons-mcp --stdioRecommended in the READMEnpx lucide-icons-mcpStarts on port 3000 by defaultnpx @modelcontextprotocol/inspector node ./build/entry.js --stdioAfter a local buildWhat you can do with it
- Lucide only, in depthOne library, covered through names, categories and usage examples.
- Category browsingGroups such as Accessibility, Charts, Design and Weather help when you know the idea.
- Fuzzy matchingNear names and typos still find the right icon.
- JSX examplesEach exact-name lookup shows how to import and render the icon in React.
- Two transportsRun stdio for desktop clients or HTTP on a local port.
- Fresh dataA crawler script refreshes icon data from the Lucide site.
- Small surfaceSeven tools, all read-only lookups, so there is little to configure.
Tools it exposes
search_icons
Searches Lucide icons by name or category, with an optional limit.
search_categories
Finds categories by partial name and returns their icon counts.
fuzzy_search_icons
Fuzzy search for icons by name.
fuzzy_search_categories
Fuzzy search for categories by name.
get_icon_usage_examples
Returns React and JSX usage examples for an exact icon name.
list_all_icons_by_category
Lists every icon in one category.
list_all_categories
Lists all categories with their icon counts.
Frequently asked questions
What is the Lucide Icons MCP server?
It is a community MCP server that exposes the Lucide React icon set to an AI agent. The agent can search icons and categories and fetch JSX usage examples, using seven lookup tools built with Bun and the MCP TypeScript SDK.
How do I install lucide-icons-mcp?
Add a server entry with the command npx and the arguments lucide-icons-mcp and --stdio to your MCP client config, then restart the client. For HTTP mode, run npx lucide-icons-mcp and it listens on port 3000.
How many icons can it search?
The README says Lucide has over 1,500 icons and that the server covers all of them. The data comes from a crawler that reads the Lucide website, so counts follow whatever the last crawl found.
Does it add icons to my project files?
No. It returns names, categories and JSX examples only, and it never touches your files. Your agent then writes the import itself in your component code. For a different icon server to compare, see Keyline Icons MCP.
Is it only for React?
The usage examples are written for Lucide React and JSX. The README does not describe Vue, Svelte or other framework output, so use another source if your project is not React.
What is the difference between stdio and HTTP mode?
Stdio is how desktop MCP clients launch a server and talk to it directly. HTTP mode runs a local web server, by default on port 3000, for clients that connect over HTTP.
What license applies?
The server code is MIT licensed. The README adds that Lucide itself is under the ISC license and reproduces its text, so the icons carry their own terms next to the code license.


