Icons MCP Server
Provides access to the Font Awesome icon library (2,000+ icons) for searching, retrieving, and using icons in applications.
Integrates with Iconify's icon sets, enabling search and retrieval of 200,000+ icons from 150+ libraries, and creation of SVG sprites.
Provides access to the Lucide icon library (1,500+ icons) for searching, retrieving, and using icons in UI designs.
Provides access to Material Design icons (7,000+ icons) via the mdi prefix for search, retrieval, and use in applications.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Icons MCP Server get a red check icon"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 buildRelated 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: 10get_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: trueconvert_icon
Convert SVG → PNG at any size.
iconData: "<svg>...</svg>"
toFormat: "png"
size: 128optimize_svg
Compress SVG with SVGO (50-70% reduction).
Icon Format
Icons use prefix:name format:
Prefix | Library | Count |
| Lucide | 1,500+ |
| Material Design | 7,000+ |
| Heroicons | 300+ |
| Tabler | 5,000+ |
| Phosphor | 7,000+ |
| Font Awesome | 2,000+ |
| 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 toolsconvert_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
Scored across 9 tools
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.
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.
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.
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
Related MCP Connectors
Search and fetch 450,000+ free SVG icons and brand logos from 270+ open-source icon sets.
Icons for agentic development: search & fetch 366,000+ open-source icons as SVG/PNG. No API key.
Search 161,000+ free icons; get SVG (single/bulk), PNG, related icons, webfont classes. No API key.
Multilingual semantic SVG icon search with previews for AI coding agents. 20,000+ icons.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides 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 npm1,471MIT
- AlicenseNot gradedqualityDmaintenanceProvides 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 npm22GPL 3.0
- AlicenseAqualityDmaintenanceProvides 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.412 npmMIT
- AlicenseCqualityDmaintenanceEnables AI-powered icon search, generation, and download from 275,000+ icons with web-based authentication and subscription plans.15 npmMIT