Iconify MCP 🔍✨

MCP server for searching, fetching, and discovering icons from Iconify — the largest icon library with 200,000+ icons across 150+ sets.

Built for Crush, Claude, and any MCP-compatible client.

Installation & Setup

1. Clone the repository:

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

2. Install dependencies:

   bun install

Related MCP server: Iconify-Icon

Tools

search_icons

Search icons by keyword across all Iconify sets.

get_icon_svg

Get raw SVG content for a specific icon.

get_icon_set

Get metadata about an icon set — total icons, categories, sample icons.

Usage

With Crush

Add to your crush.json:

{
  "mcp": {
    "iconify": {
      "type": "stdio",
      "command": "bun",
      "args": ["run", "/path/to/iconify-mcp/index.js"]
    }
  }
}

With Claude, Cline, or any MCP client

{
  "mcpServers": {
    "iconify": {
      "command": "bun",
      "args": ["run", "/path/to/iconify-mcp/index.js"]
    }
  }
}

Standalone test

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | bun index.js

echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_icons","arguments":{"query":"heart","limit":5}}}' | bun index.js

Example queries

How it works

All requests go to the public Iconify API (api.iconify.design). No authentication needed.

1. Search → GET /search?query=...

2. SVG → GET /{icon}.svg

3. Set info → GET /collection?prefix=...

License

MIT