MCP server

Better Icons MCP Server: Search 200,000 Icons From Your Agent

Better Icons is an MCP server and CLI that lets an AI coding agent search 150 plus icon collections and write the chosen SVG straight into your project's icons file.

Run
npx better-icons setup
View on GitHub

Stars, license and last push from GitHub. Install count as reported by the open skills directory.

What is the Better Icons MCP server?

Better Icons is a TypeScript MCP server and CLI from the better-auth organization. It searches more than 200,000 icons across 150 plus collections, returns SVG or framework code, and can sync an icon into your icons file so the agent does not paste markup into chat.

Better Icons gives an agent a searchable index of icons from over 150 collections, among them Lucide, Heroicons and Material Design. The same package works as an MCP server or as a plain command line tool.

The README names the problem it solves: models often do not know which icons exist, write wrong SVG, mix styles and waste tokens on inline markup. The server returns real icons by id instead.

What changes in your agent's output

  • Icon ids use a prefix:name form such as lucide:home, so the agent picks from icons that exist.
  • The sync tool writes the icon into a .tsx, .ts or .js icons file for React, Vue, Svelte, Solid or raw SVG.
  • It remembers which collections you use and ranks them first in later searches.
  • A scan tool reads your icons file so the agent can see what is already there.

Install paths

Run the setup command and it configures the server for the agents listed in the README. The README also offers an agent skill for the CLI features, or you can install the CLI globally with npm or Bun.

Who Better Icons is for

Best for

  • Front-end developers who want consistent icons added to a component project without hunting through icon sites.
  • Teams that already settled on one library, such as Lucide, and want the agent to stay inside it.
  • Builders who want to compare it with Unicon MCP, another icon search server.

Not for

  • Custom brand illustration. It retrieves existing icons and does not draw new ones.
  • Page builders that take icons from their own picker. Keyline Icons MCP offers another route, and Font MCP covers type instead.
  • Anyone needing a hosted service. The README setup runs a local npx process, with no remote endpoint listed.

Use it with UiChemy

Better Icons helps a developer pick consistent icons in code. For WordPress pages, UiChemy converts a Figma design into editable layouts, and Composer writes HTML, CSS and JS for them. Click Get Started on uichemy.com.