Better Icons

This gives Claude direct access to Iconify's 200+ icon libraries without you having to dig through documentation or copy-paste SVGs manually. The CLI is straightforward: search for icons, grab the SVG, pipe it wherever you need it. What makes it genuinely useful is the MCP server integration, which means Claude can search icons, compare styles across libraries, and even sync them directly into your React or Vue components. The batch download feature is handy when you're exploring options. It's one of those tools that removes friction from a task you do often enough to be annoying but not often enough to automate yourself.

GitHub stars: 1.1K
last updated: May 22, 2026

View on GitHub

Install

$ npx -y skills add dtsola/xiaoyaosearch --skill better-icons --agent claude-code

Installs into .claude/skills of the current project.

Files

Better Icons

Search and retrieve icons from 200+ libraries via Iconify.

Installation

Before using any better-icons commands, ensure the tool is available in the environment.

Option 1 — Install globally (recommended, matches all examples below):

# Using npm
npm install -g better-icons

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

Option 2 — Run without installing (prefix every command with npx or bunx):

# Using npx (npm)
npx better-icons search arrow --limit 10
npx better-icons get lucide:home > icon.svg

# Using bunx (Bun — faster)
bunx better-icons search arrow --limit 10
bunx better-icons get lucide:home > icon.svg

For AI agents: Prefer the global install so that better-icons is on $PATH and the commands below work as-is. Run the install step once during environment setup, then use the commands without npx/bunx.

CLI

# Search icons
better-icons search <query> [--prefix <prefix>] [--limit <n>] [--json]

# Search and download all found icons as SVG files
better-icons search <query> -d [dir] [--color <color>] [--size <px>]

SKILL.md on GitHub