Better Icons MCP Server

Overview

Better Icons is an MCP server, CLI, and Agent Skill for searching and retrieving icons from Iconify-powered collections. The upstream README describes 200,000+ icons across 150+ collections, with tools for search, recommendations, similar icons, batch retrieval, project sync, recent icons, and learned collection preferences.

Use it when an AI coding agent needs to pick real icons instead of inventing SVG paths or asking the user to manually browse icon sets.

Source Review

This listing is grounded in:

• https://github.com/better-auth/better-icons
• https://raw.githubusercontent.com/better-auth/better-icons/main/README.md
• https://raw.githubusercontent.com/better-auth/better-icons/main/package.json
• https://raw.githubusercontent.com/better-auth/better-icons/main/skills/SKILL.md
• https://registry.npmjs.org/better-icons/latest

The package is published as better-icons, exposes a better-icons binary, requires Node.js 18 or newer, and reports MIT license metadata.

Install

For Claude Code:

claude mcp add better-icons -- npx -y better-icons

For JSON-based MCP clients:

{
  "mcpServers": {
    "better-icons": {
      "command": "npx",
      "args": ["-y", "better-icons"]
    }
  }
}

Better Icons also provides an interactive setup command:

npx better-icons setup

The README says setup can configure Cursor, Claude Code, OpenCode, Windsurf, VS Code Copilot, and Google Antigravity.

MCP Tools

Skill Support

The repository also includes skills/SKILL.md, which teaches agents how to use the Better Icons CLI and MCP tools. It documents CLI commands for search, get, batch download, JSON output, better-icons setup, popular collections, Icon ID format, and MCP tool interfaces.

Install the Agent Skill separately when your host supports skill installation:

npx skills add better-auth/better-icons

Best Use Cases

• Search for Lucide, Material Design, Heroicons, Tabler, Phosphor, Remix Icon, Solar, or other Iconify-backed icons from an agent.
• Retrieve raw SVG for a known prefix:name icon ID.
• Ask an agent to recommend icons for authentication, navigation, settings, billing, empty states, or status badges.
• Batch fetch a consistent set of icons for a feature.
• Sync approved icons into a shared React, Vue, Svelte, Solid, or raw SVG icons file.

Safety Notes

Better Icons is lower-risk than a browser or cloud-control MCP server, but it still writes project files when sync_icon is used. Review generated SVGs, component names, import/export shape, and target file paths before committing. Prefer a design-system-owned icon file instead of letting an agent scatter icon code throughout unrelated components.

Duplicate Review

Checked current content/mcp/, content/skills/, content/agents/, content/tools/, open pull requests, and repository-wide content for better-auth/better-icons, Better Icons, Better Icons MCP, better-icons package, Iconify MCP, icon search MCP, and the included better-icons skill. No dedicated Better Icons MCP Server entry, exact source URL duplicate, target file, or open duplicate PR was found.

Disclosure

Editorial listing. No paid placement or affiliate link is used. Better Icons is published from the better-auth/better-icons repository under MIT license metadata.