Lucide Icons MCP Server

This project, lucide-react-mcp, is a Model Context Protocol (MCP) server built with Bun and the MCP TypeScript SDK. It exposes Lucide React icons as

Local serverstdioTypeScript

What is the Lucide Icons MCP MCP server?

Lucide icons mcp mcp server connects Lucide Icons MCP to AI assistants that speak the Model Context Protocol. This project, lucide-react-mcp, is a Model Context Protocol (MCP) server built with Bun and the MCP TypeScript SDK. It exposes Lucide React icons as resources and tools, enabling LLMs and agentic applications to search for and utilize icons. Key features include listing icons, icon search by name.

What Lucide Icons MCP does

A Model Context Protocol (MCP) server exposing Lucide React icons as resources and tools for LLMs and agentic applications. Built with Bun and the MCP TypeScript SDK.

Lucide is a beautiful & consistent icon toolkit made by the community. It's an open-source icon library that provides over 1,500+ carefully crafted icons in a single, consistent style. Originally forked from Feather Icons, Lucide has grown into one of the most popular icon libraries for modern web development.

Key capabilities

  • 🔍 Icon Search: Search through 1,500+ Lucide icons by name or category
  • 📂 Category Browsing: List icons by categories (Design, Communication, Media, etc.)
  • 💡 Usage Examples: Get React/JSX code examples for any icon
  • 🔧 Icon Information: Detailed information about each icon
  • 🚀 MCP Integration: Ready for Claude Desktop and other MCP clients
  • 🌐 Dual Mode: HTTP server or stdio-based MCP server
  • 📊 Comprehensive Coverage: All Lucide icons with proper JSX usage

Tools it exposes

Once connected, the assistant can call these 3 tools directly:

  • Description — Get usage examples for a Lucide React icon by the exact name
  • Parameters — - name (string): Search term for icon
  • Returns — React/JSX usage examples for a specific Lucide icon

Installing the lucide icons mcp mcp server

The server is distributed via npm as lucide-icons-mcp, so most clients can run it without a manual build step. Add it to your MCP client's configuration and restart the client to pick it up — the copy-paste configs for Claude Desktop, Claude Code and Cursor are on this page.

Requirements

Where it fits

Developer-tool servers are usually the first ones people connect, because they turn "help me with this code" into an assistant that can actually read the repo and act on it. Lucide Icons MCP sits in that group, and the shape of its toolset — Description, Parameters, Returns — tells you what it is really for. Worth comparing against the other developer tools servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • Maintained by SeeYangZhi, written in TypeScript.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the lucide icons mcp mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

Available tools

ToolWhat it does
DescriptionGet usage examples for a Lucide React icon by the exact name
Parameters- name (string): Search term for icon
ReturnsReact/JSX usage examples for a specific Lucide icon

How to install the Lucide Icons MCP MCP server

{
  "mcpServers": {
    "lucide-icons": {
      "command": "npx",
      "args": ["-y", "lucide-icons-mcp"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Example prompts to try

  • Use Lucide Icons MCP to Description.
  • Use Lucide Icons MCP to Parameters.
  • Use Lucide Icons MCP to Returns.

Frequently asked questions

It connects Lucide Icons MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 3 tools (Description, Parameters, Returns) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Lucide Icons MCP directly.