better-icons

MCP.Pizza Chef: better-auth

Searching for the right icon and copying its code by hand wastes time and often breaks the visual style of an app. This tool lets your assistant search across more than 150 icon collections, including Material Design, Lucide, and Font Awesome, then place the chosen icon straight into your project file in the correct format for React, Vue, Svelte, or plain SVG. It works inside coding apps such as Cursor, VS Code, Windsurf, and Claude Code, and it does not require an account or an API key to use.

Coding
Images/Design

Use This MCP server To

Search thousands of icons by keyword in seconds Get the exact code for one specific icon Add a matching icon straight into my project file Find similar icons across different styles and collections Get suggestions for which icon fits a specific feature Pull several icons at once instead of one by one

README

Better Icons

Search and retrieve 200,000+ icons from 150+ icon collections. Works as an MCP server for AI agents or CLI tool.

Quick Start

Add Skills

Enable the better-icons CLI features in your agent environment (matches all examples below):

npx skills add better-auth/better-icons

Direct CLI Installation

Alternatively, install the CLI globally for direct non-agent use:

# Using npm
npm install -g better-icons

# Using Bun (faster)
bun add -g better-icons

MCP Server (AI Agents)

Configure the MCP server to enable icon tools in your AI coding agents.

npx better-icons setup

This interactively configures the MCP server for:

  • Cursor
  • Claude Code
  • OpenCode
  • Windsurf
  • VS Code (Copilot)
  • Google Antigravity

Or configure manually.

CLI (Direct Usage)

Use the CLI to search and retrieve icons directly from your terminal.

better-icons FAQ

Can I use this to find an icon for a button I am building?
Yes — describe what you need, like "a settings icon" or "an arrow pointing right," and the assistant searches across more than 150 icon collections and shows you matching options.
Can I use this to add an icon directly into my project without copying and pasting?
Yes — the assistant can write the icon straight into your project's icons file, ready to use as a React, Vue, Svelte, or plain SVG component.
Which apps does this work in?
It is built for AI coding assistants such as Cursor, VS Code, Windsurf, and Claude Code, where it runs quietly in the background while you chat.
Do I need an account or an API key to use it?
No — there is no sign-up or key required. You add a short snippet to your app's settings, and icon search works right away.
How hard is it to set up?
Setup is a short copy-and-paste step. You either run one command that configures it automatically, or paste a small snippet into your coding app's settings file.
Will it remember which icon style I like?
Yes — it keeps track of the icon collections you use most and prioritizes those in future searches.
Can it find icons in a specific style, such as outlined or filled?
Yes — many collections include both outlined and filled versions, and you can ask for a specific look or browse similar icons across collections.
Do I need to already know how to code to use this?
It is most useful if you are already building something in a coding app, since it adds icons directly into project files, but you do not need deep programming knowledge to ask for and receive an icon.