home / mcp / better icons mcp server

Better Icons MCP Server

Provides fast access to 200,000+ icons across 150+ collections for AI agents and CLI usage.

Installation

Add the following to your MCP client configuration file.

Configuration

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

You can run Better Icons as an MCP server to empower AI agents and your CLI workflows with fast, token-efficient access to 200,000+ icons from 150+ collections. It supports several AI agents and CLI usage, letting you search, retrieve, and integrate icons directly into your projects or assistant prompts.

How to use

Use the MCP server to connect your AI agents or CLI tools to the icon library. You can enable the MCP server for various agents or run the CLI directly to search for icons, fetch SVGs, and output JSON for scripting. The server exposes a set of tools that let you search across collections, retrieve icons in multiple formats, and manage your icon usage preferences.

How to install

Prerequisites: you need Node.js and npm installed on your system. If you don’t have them, install Node.js from the official site and npm will be included.

Consolidated setup and manual configuration are available. Follow the steps below to enable the MCP server for both standard AI agent usage and your CLI workflow.

How to install standout MCP configs

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

Manual setup for Cursor MCP client

Add the following MCP server entry to your Cursor configuration file to enable Better Icons as an MCP source.

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

Manual setup for Claude Code (CLI)

Add the following MCP server entry to your Claude Code settings to enable Better Icons as an MCP source.

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

Available tools

search_icons

Search for icons across 150+ collections using a query. Supports optional filters and limits to tailor results.

get_icon

Retrieve the SVG or other supported formats for a specific icon identified by prefix and name. Can return SVG, JSX, Iconify usage, or a direct URL.

list_collections

List available icon collections or libraries and filter them by category or search term.

recommend_icons

Provide icon recommendations for a given use case with optional style and limit parameters.

get_icon_preferences

Show learned icon collection preferences with usage statistics to guide future searches.

clear_icon_preferences

Reset all learned icon preferences to start fresh.

find_similar_icons

Find similar icons or variations of a given icon across multiple collections and styles.

get_icons

Fetch multiple icons at once for batch retrieval, improving efficiency.

get_recent_icons

View recently used icons for quick reuse.

sync_icon

Add a specific icon to your project’s icons file and generate import/usage guidance.

scan_project_icons

Scan a project icons file to see what icons are already available.