Better Icons
Better Icons provides AI agents and developers access to search and retrieve icons from 200,000+ assets across 150+ icon collections (including Lucide, Heroicons, and Material Design). It offers MCP server integration for AI coding agents and CLI tools that enable icon searching, batch retrieval, similar icon discovery, and multi-framework exports while tracking user preferences. The server solves the problem of AI models struggling to identify available icons, generate correct SVG code, and maintain consistent icon styles—reducing token consumption by writing icons directly to project files rather than embedding them in chat.
- GitHub stars
- 1K
- tools
- 11
- last updated
- Jan 23, 2026
Tools
11 toolsPublic tool metadata for what this MCP can expose to an agent.
search_iconsSearch for icons across 150+ icon collections.
Search for icons across 150+ icon collections.
No parameter schema in public metadata yet.
get_iconGet the SVG code for a specific icon with multiple usage formats.
Get the SVG code for a specific icon with multiple usage formats.
No parameter schema in public metadata yet.
list_collectionsList available icon collections/libraries.
List available icon collections/libraries.
No parameter schema in public metadata yet.
recommend_iconsGet icon recommendations for a specific use case.
Get icon recommendations for a specific use case.
No parameter schema in public metadata yet.
get_icon_preferencesView your learned icon collection preferences with usage statistics.
View your learned icon collection preferences with usage statistics.
No parameter schema in public metadata yet.
clear_icon_preferencesReset all learned icon preferences to start fresh.
Reset all learned icon preferences to start fresh.
No parameter schema in public metadata yet.
find_similar_iconsFind similar icons or variations of a given icon across different collections and styles.
Find similar icons or variations of a given icon across different collections and styles.
No parameter schema in public metadata yet.
get_iconsGet multiple icons at once (batch retrieval). More efficient than multiple `get_icon` calls.
Get multiple icons at once (batch retrieval). More efficient than multiple `get_icon` calls.
No parameter schema in public metadata yet.
get_recent_iconsView your recently used icons for quick reuse.
View your recently used icons for quick reuse.
No parameter schema in public metadata yet.
sync_iconGet an icon AND automatically add it to your project's icons file. The recommended way to add icons.
Get an icon AND automatically add it to your project's icons file. The recommended way to add icons.
No parameter schema in public metadata yet.
scan_project_iconsScan an icons file to see what icons are already available.
Scan an icons file to see what icons are already available.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
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
CLI (Direct Usage)
Use the CLI to search and retrieve icons directly from your terminal.
# 1. Search for icons (finds icons across 150+ collections)
npx better-icons search arrow --limit 10
npx better-icons search home --prefix lucide
Details
- Repository
- github.com/better-auth/better-icons