iconify

The Iconify MCP Server exposes a set of tools that let AI assistants query Iconify's rich icon catalog. It runs as a standard IO-based MCP server, so you can connect it to any MCP-compatible client, including Cursor, Claude Code, Windsurf, or other MCP-enabled tooling. The available tools include: get_all_icon_sets to list every icon set available in Iconify; get_icon_set to fetch detailed metadata for a specific set; search_icons to perform flexible icon searches across sets with support for pagination and filtering; and get_icon to retrieve detailed data for a single icon along with usage examples for UnoCSS, Tailwind, Iconify web components, and various framework integrations. These tools enable dynamic icon browsing, discovery, and integration into design systems or code generators.

To use the server, connect your MCP client and call one of the tools by name (for example, get_all_icon_sets or search_icons) with the required parameters. The responses are JSON payloads containing metadata, icons, and usage examples that you can render in your UI or use to drive code generation for icons in your project.

Prerequisites:

• Node.js v18.x or newer installed on your system
• npm or npx available in your environment

Installation steps:

1. Install and run the MCP server via npx (recommended):

npx -y iconify-mcp-server@latest

This starts the server using the default configuration defined in the README (the iconify-mcp-server package exposes the MCP interface via STDIO).

2. If you want to define a static config file for Cursor or Windsurf, you can create an mcp.json as shown in the README:

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

3. For development or local testing, you can clone the repository and install dependencies, then build/run as described in the repository's Development section. Typical commands:

git clone https://github.com/imjac0b/iconify-mcp-server.git
cd iconify-mcp-server
bun install
bun run build
bun run dist/index.js

Note: The exact startup command may vary if you use a different runtime or integration (Cursor, Claude Code, Windsurf) with a dedicated MCP config file.

Tips and caveats:

• This MCP server is designed to work with standard MCP clients via STDIO. Ensure your client is configured to communicate over the expected protocol.
• The npm package to install is iconify-mcp-server; using npx with -y will fetch the latest version automatically.
• If you plan to customize the server behavior, refer to the Iconify MCP server's repository for any environment-specific configurations or feature flags.
• When testing, you can use the MCP Inspector or CLI calls shown in the README to verify responses and data schemas.
• For large icon sets, be mindful of response payload sizes and consider using pagination parameters (start, limit) in search_icons or get_icon_set when dealing with big collections.