Skip to main content
Glama

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

search_icons

Finds icons by name, tag or category, e.g. "delivery truck".

get_icon

Returns one icon as SVG in a chosen style, size, colour, secondary colour and stroke width. Can write it to an .svg file.

compare_styles

Returns one icon in every installed style, so you can pick one.

list_styles

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 build

This 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_KEY

The 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.js

Claude 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 test

test/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 tools
compare_stylesCompare one Hugeicon across stylesA
Read-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 stylesA
Read-only

Shows which of the 10 styles are installed and how to add the missing ones.

Inputs: no named parameters.

search_iconsSearch HugeiconsA
Read-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

    A4/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Visual 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
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to search, retrieve, and save Nucleo icons from the user's local library directly into projects.
      15 npm
      9
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to search and download SVG icons from iconfont.cn, with support for style filtering and automatic login.
      2
      MIT