Better Icons
Search and drop in icons from 150+ Iconify collections as an MCP server, CLI and skill, writing SVG straight into the project
Medium risk
We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.
Why this level
- Writes icon files into the project and reaches the network for Iconify data
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/better-iconsDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
Run in a terminal
claude mcp add --transport stdio better-icons -- npx -y better-iconsOr add to the file .mcp.json, in the project
{
"mcpServers": {
"better-icons": {
"command": "npx",
"args": [
"-y",
"better-icons"
]
}
}
}If the file already exists, add the server inside the mcpServers key.
The button opens the agent and offers to add the server. If nothing happens, copy the config below.
Add to the file ~/.cursor/mcp.json, for all projects
{
"mcpServers": {
"better-icons": {
"command": "npx",
"args": [
"-y",
"better-icons"
]
}
}
}If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.
The button opens the agent and offers to add the server. If nothing happens, copy the config below.
Run in a terminal
code --add-mcp '{"name":"better-icons","type":"stdio","command":"npx","args":["-y","better-icons"]}'Or add to the file .vscode/mcp.json, in the project
{
"servers": {
"better-icons": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"better-icons"
]
}
}
}If the file already exists, add the server inside the servers key.
Run in a terminal
codex mcp add better-icons -- npx -y better-iconsOr add to the file ~/.codex/config.toml, for all projects
[mcp_servers.better-icons]
command = "npx"
args = ["-y", "better-icons"]If the file already exists, append the block to the end.
Add to the file ~/.gemini/settings.json, for all projects
{
"mcpServers": {
"better-icons": {
"command": "npx",
"args": [
"-y",
"better-icons"
]
}
}
}If the file already exists, add the server inside the mcpServers key.
Add to the file ~/.config/devin/mcp_config.json, for all projects
{
"mcpServers": {
"better-icons": {
"command": "npx",
"args": [
"-y",
"better-icons"
]
}
}
}If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.
Formerly Windsurf.
Add to the file cline_mcp_settings.json, for all projects
{
"mcpServers": {
"better-icons": {
"command": "npx",
"args": [
"-y",
"better-icons"
]
}
}
}If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.
Add to the file .roo/mcp.json, in the project
{
"mcpServers": {
"better-icons": {
"command": "npx",
"args": [
"-y",
"better-icons"
]
}
}
}If the file already exists, add the server inside the mcpServers key.
A fork of Roo Code, same .roo folders.
Add to the file opencode.json, in the project
{
"mcp": {
"better-icons": {
"type": "local",
"command": [
"npx",
"-y",
"better-icons"
]
}
}
}If the file already exists, add the server inside the mcp key.
Add to the file ~/.config/zed/settings.json, for all projects
{
"context_servers": {
"better-icons": {
"command": "npx",
"args": [
"-y",
"better-icons"
]
}
}
}If the file already exists, add the server inside the context_servers key.
Add to the file .codeassistant/mcp.json, in the project
{
"mcpServers": {
"better-icons": {
"command": "npx",
"args": [
"-y",
"better-icons"
]
}
}
}If the file already exists, add the server inside the mcpServers key.
Add it as a skill with npx skills add better-auth/better-icons, or configure the MCP server interactively with npx better-icons setup. For direct use install the CLI globally: npm install -g better-icons.
Other ways from the author
npx skills add better-auth/better-iconsAdds better-icons features as a skill in the agent environment.
This is third-party code. Review the repository files before installing.
What it does
The tool gives the agent access to the Iconify catalog: search across 150+ collections, fetch SVG by an id like prefix:name, list collections and recommend an icon for a use case. Icons can be written straight into the project's icon file in tsx, ts or js formats instead of pasting SVG into chat, which saves tokens. There is batch retrieval, discovery of similar icons across collections and memory of the ones you already used. It works three ways: as an MCP server for agents, as a CLI in the terminal and as a skill with a SKILL.md file. No key or account is needed, and export covers React, Vue, Svelte, Solid and raw SVG.
Who it is for. For frontend developers and designers who need project icons without hunting on icon sites.
Good fit when
- You need an icon while coding UI without switching to a browser
- You want a consistent icon style from a single collection
- You want SVG written into a project file rather than pasted into chat
Not a fit when
- You need a custom illustration that no Iconify collection has
- You are offline and Iconify data is not available locally
Example request
Find a cart icon in the lucide collection and add it to my icons fileLimitations
The tool relies on Iconify data, so network access is required. Icons follow the licenses of their source collections, which you should check before shipping. It does not draw custom icons, it only returns what the catalog already has.
How to disable. Remove the better-icons entry from the MCP config, uninstall the global package with npm uninstall -g better-icons, or delete the skill folder.
MCP
- Transport
- stdio
- Authentication
- not required
Security check
- Writes icon files into the project and reaches the network for Iconify data
README in short
The README describes a tool for searching and fetching over 200,000 icons from 150+ Iconify collections that works as an MCP server, CLI and skill. The quick start offers adding the skill via npx skills add, configuring MCP with npx better-icons setup, or installing the CLI globally. It lists the MCP tools: search_icons, get_icon, list_collections, recommend_icons and preference viewing. It also covers writing icons straight into a project file, batch retrieval, similar-icon search and memory of used collections. It gives manual setup snippets for Cursor, Claude Code and other clients, MIT licensed.
FAQ
Do I need a key or sign-up?
No. It pulls icons from Iconify, so no key or account is required, only network access.
How do the install methods differ?
The MCP server adds icon tools to the agent, the CLI runs in the terminal, and the SKILL.md skill documents the same commands for an agent environment.
Related
Official Claude Code plugin from the Next.js repo: adopting Cache Components and Partial Prefetching, and verifying changes on a running dev server
Official shadcn/ui skill and MCP server: the agent searches registries, adds components via the CLI and follows the library's rules
A frontend design skill with 23 commands, live browser iteration and 61 detector rules for common AI-generated UI tells
Vercel Agent Skills
Agent Skills
Vercel's skills: React and Next.js performance, UI guideline audits, React Native, component composition and deploys