Hugeicons for AI agents
When Claude, ChatGPT, Codex or Cursor builds a UI, it should use real icons, not guessed names or hand-drawn SVGs. Connect your agent to Hugeicons and it searches 60,000+ icons, installs the right package, and writes import code that works the first time.
> Build a post actions dropdown menu.
● package.json · found @hugeicons-pro/core-solid-rounded
● hugeicons · search_icons("edit, view, link, hide, pin, comment, delete, notification")
● hugeicons · get_icon_code("link-05", "react", "solid-rounded")
import { HugeiconsIcon } from '@hugeicons/react'
import {
PencilEdit01Icon,
ViewIcon,
Link05Icon,
ViewOffSlashIcon,
PinIcon,
CommentBlock03Icon,
Delete02Icon,
Notification01Icon,
} from '@hugeicons-pro/core-solid-rounded'✓ Your project already uses Hugeicons Pro, so I kept its Solid Rounded style. Every name above was checked against the live catalog.
Result
Pick the tool you build with. Every option talks to the same hosted Hugeicons MCP server,
so names are always checked against the current library.
The official plugin. One install adds the MCP server and both Hugeicons skills, so Claude picks the library, installs it and resolves every icon name.
claude plugin marketplace add hugeicons/hugeiconsclaude plugin install hugeicons@hugeiconsPublished in the OpenAI plugin directory. Enable it once and it works in ChatGPT conversations and in Codex under the same account.
Settings → Apps & Connectors → search “Hugeicons” → Enable
A rule file that attaches when the agent edits UI files, plus the MCP server it resolves icon names against.
curl --create-dirs -o .cursor/rules/hugeicons.mdc https://raw.githubusercontent.com/hugeicons/hugeicons/main/plugins/cursor/hugeicons.mdcClaude Desktop, VS Code, Windsurf, Zed and every client that speaks Streamable HTTP. Paste the URL as a remote server. No API key.
https://mcp.hugeicons.com/mcpInstructions any skills-compatible agent loads from your project: which package, which component, which props, and never guessing a name.
npx skills add hugeicons/hugeiconsAsk for a dashboard, a sidebar or an empty state.
The agent handles the icons in three steps.
Hugeicons already in the project? The agent uses it in your existing style. Another library like lucide or Heroicons? It stays with it and never mixes. No icon library at all? It installs Hugeicons, free Stroke Rounded with 6,000+ icons, even when your prompt never mentioned icons.
Instead of recalling names from training data, the agent searches the live catalog for everything the screen needs in one call: “wallet, transfer, invoice, settings”.
It fetches the exact install command, import and export name for your framework, then copies it verbatim. 2nd-bracket is SecondBracketIcon, and the agent never has to guess that.
Hosted at https://mcp.hugeicons.com/mcp. No API key, 300 requests per minute per IP.
Every name is resolved against the live catalog, so imports never fail on install.
Agents use the official package or web font, not paths that only look like an icon.
One style and one size scale across the UI, with 10 styles to choose from.
Enough coverage that the agent finds a real match instead of settling for something close.
Agents use free Stroke Rounded unless your project already has Pro or you ask for it.
Point any agent at the hosted server and start. Nothing to sign up for.
You don't need to mention icons. Ask for the screen, and the agent brings the right ones.
Build a settings page with a sidebar.
Design a fintech dashboard with icons for wallet, transfer, invoice and settings.
Add a notification bell to the header.
Replace lucide-react with Hugeicons across this app.
Set up Hugeicons in this Flutter app and use a home icon in the bottom nav.
Use Hugeicons as a web font on a plain HTML page and add a heart icon next to a Favorite button.
Common questions about using Hugeicons
with Claude, ChatGPT, Codex, Cursor and other MCP clients.
It is a set of integrations that let AI coding agents use the Hugeicons library correctly: a hosted MCP server that searches all 60,000+ icons and returns exact import code, an agent skill that tells the agent how to install and render icons, and ready-made plugins for Claude Code, ChatGPT, Codex and Cursor.
Claude Code, Claude (claude.ai and Claude Desktop), ChatGPT, Codex, Cursor, VS Code, Windsurf, Zed and any other client that supports remote MCP servers over Streamable HTTP. The agent skill works in any tool that supports the open skills format.
No. The MCP server is hosted at https://mcp.hugeicons.com/mcp and needs no key or sign-up. It allows 300 requests per minute per IP address, which is plenty for normal use.
Yes. The MCP server, skills and plugins are free, and agents default to the free Stroke Rounded style (@hugeicons/core-free-icons, 6,000+ icons). They only use a Pro style when your project already imports @hugeicons-pro packages or you ask for one.
Language models recall icon names from training data, and those names are often wrong or out of date, so imports fail. When there is no icon library, agents tend to hand-draw SVG paths that look rough and inconsistent. Hugeicons gives the agent a real, searchable library, so every icon is professionally drawn and every name exists.
No. If your project uses lucide, Heroicons, react-icons, Material, Feather, Phosphor or Tabler, the agent stays with it and does not mix libraries. It switches only when you ask, and then the hugeicons-migrate skill moves the project over with verified name maps.
The MCP server is the live connection the agent searches and resolves names against. The skill is the set of instructions telling the agent how to use Hugeicons in your project. The Claude Code, ChatGPT & Codex and Cursor plugins bundle both, so you install once and you are done.
React, Vue, Angular, Svelte, SolidJS, React Native and Flutter, plus plain HTML through the Hugeicons web font. The agent detects your framework from package.json or pubspec.yaml and installs the matching package.
Yes. If your client only supports local servers, run npx -y @hugeicons/mcp-server (Node.js 18 or later). In Claude Code: claude mcp add --transport stdio hugeicons -- npx -y @hugeicons/mcp-server.
