Iconify MCP Server

Iconify MCP Server

An MCP (Model Context Protocol) server that provides AI assistants with access to Iconify's extensive collection of over 200,000 open source vector icons from 200+ icon sets.

Features

• Get all icon sets: Browse all available icon collections
• Get specific icon set: Retrieve detailed information about a specific icon set
• Search icons: Search through icons with flexible query parameters
• Get icon data: Retrieve specific icon data with usage examples for popular frameworks

Installation

Install in Cursor

Go to: Settings -> Cursor Settings -> MCP -> Add new global MCP server

Pasting the following configuration into your Cursor ~/.cursor/mcp.json file is the recommended approach. You may also install in a specific project by creating .cursor/mcp.json in your project folder. See Cursor MCP docs for more info.

{
  "mcpServers": {
    "iconify": {
      "command": "npx",
      "args": ["-y", "iconify-mcp-server@latest"]
    }
  }
}

Install in Claude Code

Run this command. See Claude Code MCP docs for more info.

claude mcp add iconify -- npx -y iconify-mcp-server@latest

Install in Windsurf

Add this to your Windsurf MCP config file. See Windsurf MCP docs for more info.

{
  "mcpServers": {
    "iconify": {
      "command": "npx",
      "args": ["-y", "iconify-mcp-server@latest"]
    }
  }
}

Cursor One-Click Install

Usage

This MCP server runs as a stdio server and can be integrated with MCP-compatible clients.

Available Tools

`get_all_icon_sets`

Get a list of all available icon sets from Iconify.

Response: JSON object containing all icon collections with metadata.

`get_icon_set`

Retrieve detailed information about a specific icon set.

Parameters:

• set (string): The icon set prefix (e.g., "mdi", "heroicons", "lucide")

Response: JSON object with icon set information including total icons, categories, etc.

`search_icons`

Search for icons across all or specific icon sets.

Parameters:

• query (string): Search query
• limit (number, optional): Maximum results (32-999, default: 64)
• start (number, optional): Starting index for pagination
• prefix (string, optional): Icon set prefix to limit search scope

Response: JSON array of matching icons with metadata.

`get_icon`

Get detailed information about a specific icon.

Parameters:

• set (string): Icon set prefix
• icon (string): Icon name

Response: Icon data with usage examples for:

• UnoCSS
• Tailwind CSS
• Iconify Icon web component
• Vue (Iconify)
• React (Iconify)
• Svelte (Iconify)
• Astro
• Unplugin Icons

Build

bun run build

Development

Prerequisites

• Node.js >= 18.0.0
• Bun runtime

Setup

1. Clone the repository:

git clone https://github.com/imjac0b/iconify-mcp-server.git
cd iconify-mcp-server

2. Install dependencies:

bun install

3. Build the project:

bun run build

4. Run in development mode:

bun run dist/index.js

Project Structure

src/
├── index.ts          # Main MCP server implementation
├── utils.ts          # Utility functions
└── ...

dist/                 # Built output
├── index.js          # ES module build
├── index.cjs         # CommonJS build
└── index.d.ts        # TypeScript definitions

Testing

Test the MCP server using the MCP Inspector:

npx -y @modelcontextprotocol/inspector bun run dist/index.js

This will open a web interface where you can test all available tools interactively.

Usage Examples

Get All Icon Sets

# This would be called by your MCP client
# Returns: JSON object with all available icon collections
get_all_icon_sets

Get Specific Icon Set

# Get information about Material Design Icons
get_icon_set({"set": "mdi"})

Search Icons

# Search for "home" icons across all sets
search_icons({"query": "home", "limit": 10})

# Search for "heart" icons in Lucide set only
search_icons({"query": "heart", "prefix": "lucide"})

Get Icon Data

# Get detailed information about a specific icon
get_icon({"set": "heroicons", "icon": "home"})

API Reference

All tools return structured JSON responses. See the tool definitions above for detailed parameter and response information.

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (`git push origin feature/amazi