lucide-mcp

MCP server for searching, retrieving, and adding Lucide SVG icons from AI coding agents.

Resources

• lucide://icons/{name}.svg - read raw SVG markup for an icon, for example lucide://icons/panel-left.svg

Tools

• search_icons - search icons by exact, partial, and fuzzy name matching
• get_icon_metadata - return tags, aliases, SVG path, and suggestions for an icon
• get_icon_svg - return raw SVG markup for an icon
• add_icon_to_project - write an SVG file into the current project
• list_icons - list available Lucide icon names

Usage

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

With a local checkout:

{
  "mcpServers": {
    "lucide": {
      "command": "node",
      "args": ["/path/to/lucide-mcp/dist/index.mjs"]
    }
  }
}

Examples

Search for sidebar icons:

search_icons({ "query": "sidebar", "limit": 5 })

Get icon metadata:

get_icon_metadata({ "name": "panel-left" })

Read SVG as a resource:

lucide://icons/panel-left.svg

Get raw SVG with a tool:

get_icon_svg({ "name": "panel-left" })

Get cleaned SVG markup:

get_icon_svg({
  "name": "panel-left",
  "stripLicense": true,
  "stripClass": true,
  "strokeWidth": 1.5
})

Add an icon to a project:

add_icon_to_project({
  "name": "panel-left",
  "outputDir": "assets/icons",
  "overwrite": false,
  "stripLicense": true,
  "stripClass": true
})

The default output directory is assets/icons. Existing files are not overwritten unless overwrite is set to true. Use stripLicense, stripClass, and strokeWidth to customize the generated SVG markup.

Agent behavior

Agents can use this server when they need an icon for a UI feature and the project does not already contain a suitable SVG. A good workflow is:

1. Inspect existing project icons first.
2. Search Lucide with a semantic query.
3. Pick the best named icon.
4. Add it to the project's icon directory.
5. Use the SVG according to the project's conventions.

Development

pnpm install
pnpm test
pnpm build
pnpm typecheck

Run locally:

pnpm dev

License

MIT. Lucide icons are distributed by the Lucide project under the ISC license.