Better Icons MCP Server: Setup for Claude, Cursor and Other Apps

• Finds icons across 150+ icon libraries

  Searches the Iconify catalog by keyword and returns icon IDs such as lucide:home. You can limit results, filter by collection or category.

  Try: “Search for arrow icons in the lucide collection.”

  Network · search_icons

• Gets the SVG code for one icon

  Fetches one icon by its ID and returns raw SVG, ready-made component code and a usage example, or a direct URL. It also records the icon in your local history.

  Try: “Get the SVG for mdi:home in blue at 24 pixels.”

  Write · get_icon

• Gets up to 20 icons at once

  Fetches several icons in one call and returns all their SVGs together. It also records them in your local history.

  Try: “Get lucide:home, lucide:user and lucide:settings together.”

  Write · get_icons

• Adds an icon straight into your project's icons file

  Fetches an icon and writes it into the icons file you name, as a React, Vue, Svelte, Solid or plain SVG component, then returns the import line. It saves you pasting SVG into chat.

  Try: “Add lucide:home to src/components/icons.tsx as a React component.”

  Write · sync_icon

• Lists the icons already in your icons file

  Reads the icons file you point at and shows which icons it already has, so the assistant avoids duplicates.

  Try: “What icons are already in src/components/icons.tsx?”

  Files · scan_project_icons

• Finds the same icon in other styles or libraries

  Looks for variations of an icon, such as solid and outline versions or the same symbol from another collection.

  Try: “Find icons similar to lucide:home in other styles.”

  Network · find_similar_icons

• Suggests icons for a use case

  Takes a description such as navigation menu or settings button and a style preference, then recommends matching icons.

  Try: “Recommend outline icons for a settings button.”

  Network · recommend_icons

• Lists the icon libraries available

  Returns the available icon collections, which you can filter by category or search by name.

  Try: “Which icon collections are available for brand logos?”

  Network · list_collections

• Shows icons you used recently

  Returns your recently retrieved icons from the local history file, so you can reuse them.

  Try: “Show the icons I used recently.”

  Files · get_recent_icons

• Shows which icon libraries it has learned you prefer

  Reports the collections the server has learned you use most, which it ranks higher in later searches.

  Try: “Which icon libraries do you think I prefer?”

  Files · get_icon_preferences

• Resets what it learned about your icon choices

  Overwrites the local preferences and history file with empty values, so learning starts from scratch.

  Try: “Reset my icon preferences.”

  Write · clear_icon_preferences

Watch out for

• sync_icon writes to any file path it is given

  The tool adds an icon component to the icons file path the assistant supplies and the README documents no restriction to your project. Check the path and review the change in version control. github.com

• It keeps a history file in your home folder

  Icon lookups are saved to ~/.better-icons/preferences.json to learn your favorite libraries. clear_icon_preferences resets it. github.com

• One tool description steers the assistant

  The sync_icon description says it is the recommended way to add icons to your project, so the assistant may prefer it over simply showing the SVG. github.com

Security advisories