hugeicons-mcp
Search Hugeicons and render them as customizable SVG markup, optionally saving files, and inspect installed styles.
Search icons by name, tag, or category, with an adjustable result limit.
Get one icon as SVG in a chosen style, size, color, secondary color, and stroke width.
Optionally save the SVG to an absolute or
~/...path, with overwrite control.Compare the same icon across every installed style.
List installed styles and see how to add missing Pro styles.
Use the free stroke-rounded set, or all 10 styles with a Hugeicons Pro license.
Not a direct API integration, but supports a Figma workflow: the get_icon tool can write an icon as an .svg file to a given path (optionally with a chosen style, size, colour and secondary colour, and with overwrite control), which an assistant can then upload into Figma using the Figma MCP.
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., "@hugeicons-mcp Find a delivery truck icon as duotone-rounded SVG in #0f172a"
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.
hugeicons-mcp
An MCP server that gives AI assistants Hugeicons as SVG markup. With a Hugeicons Pro licence you get all 10 styles: stroke, solid and duotone in their variants, plus twotone and bulk. Without one you get the free stroke-rounded set. Each style has about 6,000 icons.
It runs on your machine. The icons come from the npm packages your licence installs, and the server renders them to SVG locally. The only network call is to hugeicons.com/api/icons for search tags, cached for 7 days. There is no telemetry.
The official @hugeicons/mcp-server does something different. It returns icon-font glyphs and setup docs, not SVG, and it has no Pro styles.
Tools
Tool | What it does |
| Finds icons by name, tag or category, e.g. "delivery truck". |
| Returns one icon as SVG in a chosen style, size, colour, secondary colour and stroke width. Can write it to an |
| Returns one icon in every installed style, so you can pick one. |
| Shows which styles are installed and how to add the rest. |
Names match the ones on hugeicons.com (delivery-truck-01, 1st-bracket). Code names such as DeliveryTruck01Icon work too.
Related MCP server: Svg/icons MCP
Install
You need Node and pnpm. It is built and tested on Node 26.
git clone https://github.com/yakshitpatel/hugeicons-mcp.git
cd hugeicons-mcp
pnpm install --trust-lockfile
pnpm buildThis gives you the free stroke-rounded style. Without a Pro key, plain pnpm install fails with a 401: pnpm 12 checks every package in the lockfile against its registry before installing, and the Hugeicons registry refuses the Pro packages without a key. --trust-lockfile skips that check, and pnpm then leaves out the Pro packages because they are optional. Don't use --no-optional instead: it also drops TypeScript's native compiler, and pnpm build fails. Tested on pnpm 12.8.1.
Pro styles
Copy your Universal License Key from the Tokens tab of your Hugeicons account, add this line to ~/.npmrc, then run pnpm install again, without the flag:
//npm.hugeicons.com/:_authToken=YOUR_UNIVERSAL_LICENSE_KEYThe repo's own .npmrc already points @hugeicons-pro at the Hugeicons registry. Keep the key in your home folder so it never lands in git.
Connect it
Claude Code:
claude mcp add hugeicons -s user -- node /absolute/path/to/hugeicons-mcp/dist/index.jsClaude Desktop, Cursor and other clients take the same command in their MCP config:
{
"mcpServers": {
"hugeicons": {
"command": "node",
"args": ["/absolute/path/to/hugeicons-mcp/dist/index.js"]
}
}
}Use it
Ask in plain words:
"Find a Hugeicon for notifications and give me the duotone-rounded SVG in #0f172a with an orange secondary colour."
"Show me the home icon in every style."
"Save the solid-sharp settings icon to ~/Desktop/settings.svg at 48px."
To get an icon into Figma, ask for it with a save_to path and have your assistant upload that file with the Figma MCP.
Colours are hex (#0f172a), rgb(), hsl() or oklch() values, currentColor or transparent. Your assistant turns "orange" into a hex value.
save_to takes an absolute path or one starting with ~/. It only writes regular files ending in .svg, refuses symbolic links, hard links and pipes, and won't replace an existing file unless you pass overwrite: true.
Develop
pnpm build
pnpm testtest/real-packages.test.mjs parses and renders every icon in every installed style, about 60,000 files with Pro installed. It finishes in about 15 seconds.
Licence
The code is MIT. The icons are not part of this repo: they belong to Hugeicons and are covered by your Hugeicons licence. Pro icons need a valid Pro licence. This project is not affiliated with Hugeicons.
Available Tools
4 toolscompare_stylesCompare one Hugeicon across stylesARead-only
Returns the same icon as SVG in every installed style, to choose between them.
Inputs: name (required), size, color.
get_iconGet a Hugeicon as SVGA
Returns one icon as SVG markup in the chosen style. Optionally writes it to an .svg file (use an absolute path), for example to upload into Figma.
Inputs: name (required), size, color, style, +4 more.
list_stylesList installed Hugeicons stylesARead-only
Shows which of the 10 styles are installed and how to add the missing ones.
Inputs: no named parameters.
search_iconsSearch HugeiconsARead-only
Find Hugeicons by name, tag or category. Returns names to pass to get_icon.
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool serves a clearly distinct purpose: searching, retrieving a single SVG, listing styles, and comparing all styles. The boundary between get_icon and compare_styles is well defined by the latter returning every installed style for comparison.
All four tools follow a consistent verb_noun convention: get_icon, list_styles, search_icons, compare_styles. There is no mixing of camelCase, vague verbs, or inconsistent patterns.
Four tools are well scoped for an icon lookup server: search, inspect installed styles, retrieve an icon, and compare styles. Each tool earns its place without redundancy.
The core workflow of finding, inspecting, and retrieving icons is covered, including style discovery and comparison. Minor gaps such as explicit category/tag enumeration or richer icon metadata exist, but agents can work around them via search.
Related MCP Connectors
Multilingual semantic SVG icon search with previews for AI coding agents. 20,000+ icons.
Icons for agentic development: search & fetch 366,000+ open-source icons as SVG/PNG. No API key.
Search open SVG icon packs and fetch exact SVG markup from coding agents through MCP.
Lets AI assistants draw: logos, posters, illustrations and scenes, as editable SVG and PNG.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceVisual icon search, retrieval, and comparison for AI agents. Search 200k+ icons semantically, render side-by-side comparison grids, and retrieve raw SVG markup — all tools return images so vision-capable LLMs can see the icons.1-

Svg/icons MCPofficial
AlicenseNot gradedqualityCmaintenanceEnables AI coding tools to search, inspect, recommend, and export SVG icons from svgicons.com for use in design systems, frontend projects, and AI-assisted workflows.MIT- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to search, retrieve, and save Nucleo icons from the user's local library directly into projects.15 npm9MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to search and download SVG icons from iconfont.cn, with support for style filtering and automatic login.2MIT