Skip to main content
Glama
Icons MCP Server

Icons MCP Server

by devstroop

Icons MCP Server

An MCP server providing access to 200,000+ icons from 150+ libraries. Search, retrieve, convert, and optimize icons for your applications.

Installation

git clone https://github.com/devstroop/icons-mcp.git
cd icons-mcp
npm install
npm run build

Related MCP server: Iconify MCP Server

Setup

VS Code (.vscode/mcp.json):

{
  "servers": {
    "icons": {
      "command": "node",
      "args": ["/path/to/icons-mcp/dist/index.js"]
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "icons": {
      "command": "node",
      "args": ["/path/to/icons-mcp/dist/index.js"]
    }
  }
}

Tools

recommend_icons

Get icon suggestions for UI use cases.

useCase: "navigation" | "ecommerce" | "user" | "status" | "settings" | "social" | ...

search_icons

Search 200k+ icons by keyword.

query: "shopping cart"
limit: 10

get_icon

Get a single icon as SVG/PNG.

name: "lucide:home"
size: 24
color: "#000"

get_multiple_icons

Batch fetch up to 50 icons.

icons: [{ name: "lucide:home" }, { name: "lucide:user" }]

list_libraries

List available icon libraries.

list_categories

Get categories from a library.

create_sprite

Combine icons into a single SVG sprite.

icons: ["lucide:home", "lucide:user"]
library: "iconify"
optimize: true

convert_icon

Convert SVG → PNG at any size.

iconData: "<svg>...</svg>"
toFormat: "png"
size: 128

optimize_svg

Compress SVG with SVGO (50-70% reduction).


Icon Format

Icons use prefix:name format:

Prefix

Library

Count

lucide

Lucide

1,500+

mdi

Material Design

7,000+

heroicons

Heroicons

300+

tabler

Tabler

5,000+

ph

Phosphor

7,000+

fa6-solid

Font Awesome

2,000+

simple-icons

Brand Logos

3,000+

Browse all: icon-sets.iconify.design


Examples

Get home icon:

{ "name": "lucide:home" }

Search icons:

{ "query": "arrow", "limit": 5 }

Dashboard icons:

{
  "icons": [
    { "name": "lucide:home" },
    { "name": "lucide:users" },
    { "name": "lucide:settings" }
  ]
}

Status icons with colors:

{
  "icons": [
    { "name": "lucide:check", "color": "#22c55e" },
    { "name": "lucide:x", "color": "#ef4444" }
  ]
}

License

MIT

Available Tools

9 tools
convert_iconC

Convert SVG icon to PNG format using Sharp. Supports custom sizes.

Inputs: iconData (required), toFormat (required), fromFormat (required), size.

create_spriteB

Generate an SVG sprite sheet combining multiple icons. Useful for web apps that need multiple icons.

Inputs: icons (required), library (required), format, optimize.

get_iconB

Get a specific icon by name. For Iconify, use "prefix:name" format (e.g., "mdi:home", "lucide:settings", "simple-icons:github"). Returns SVG content ready for use.

Inputs: name (required), size, color, format, +2 more.

get_multiple_iconsB

Fetch multiple icons in a single request. Efficient for getting several icons at once. Maximum 50 icons per request.

Inputs: icons (required), format, optimize.

list_categoriesB

Get available icon categories/styles from a library (e.g., solid, outline, brands)

Inputs: library (required).

list_librariesA

List all available icon libraries with details. START HERE to understand available icon sources. Returns library info, popular icon sets (mdi, lucide, heroicons, etc.), and usage examples.

Inputs: no named parameters.

optimize_svgB

Clean and optimize SVG content using SVGO. Removes metadata, comments, and unnecessary attributes to reduce file size.

Inputs: svgContent (required), options.

recommend_iconsB

Get AI-friendly icon recommendations for common UI use cases. Supports: navigation, sidebar, user, authentication, ecommerce, payment, files, media, status, settings, dashboard, development, brands, weather, calendar, search, communication, social, actions, crud. Returns curated icon suggestions with usage examples.

Inputs: useCase (required), limit, style.

search_iconsA

Search for icons across 200,000+ icons from 150+ icon sets. Use "iconify" library (default) for best results. Icons are returned in "prefix:name" format (e.g., "mdi:home", "lucide:settings").

Inputs: query (required), limit, libraries.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 9 tools

    Disambiguation4/5

    Most tools have distinct purposes: discovery (list_libraries, search_icons, list_categories), retrieval (get_icon, get_multiple_icons), and processing (convert_icon, create_sprite, optimize_svg). However, list_libraries and list_categories both list available items, which could cause minor confusion, though the latter is scoped to categories within a library.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (list_libraries, search_icons, get_icon, get_multiple_icons, list_categories, convert_icon, create_sprite, optimize_svg), with recommend_icons as the only minor deviation. The pattern is clear and predictable.

    Tool Count5/5

    9 tools are well-scoped for an icon management server, covering discovery, retrieval, conversion, sprite creation, and optimization without redundancy. Each tool serves a distinct purpose.

    Completeness4/5

    The surface covers discovery, retrieval, conversion, and optimization comprehensively. Minor gaps include no direct PNG-to-SVG conversion and no tool for managing local icon collections, but these are not core to the server's purpose.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides access to over 200,000 icons from 150+ collections with features for searching, recommendations, and direct file synchronization. It supports multiple frameworks and optimizes AI performance by writing icon code directly to project files.
      1,352 npm
      1,471
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides access to over 200,000 open-source vector icons from more than 200 icon sets via the Iconify API. It enables users to browse, search, and retrieve specific icon data along with usage examples for popular web frameworks like React, Vue, and Tailwind CSS.
      426 npm
      22
      GPL 3.0
    • A
      license
      A
      quality
      D
      maintenance
      Provides access to Iconify's 200,000+ open source vector icons from 200+ icon sets, enabling search, browsing, and retrieval of icon data with framework usage examples.
      4
      12 npm
      MIT