PlugWiki
hugeicons logo

Hugeicons MCP Server: Setup for Claude Code, Cursor and Other Apps

OfficialRemoteLocal
Getnpm@hugeicons/mcp-serverhugeicons/hugeicons

Lets Claude, Cursor or Codex look up the right Hugeicons icon and write the exact code to use it.

This is Hugeicons' own server. It lets your assistant search the icon catalog, then return the install command, import and usage for your framework, so it stops inventing icon names. You connect to the hosted address with no account, or run it on your computer. Only the free stroke-rounded style comes without a Hugeicons Pro license.

Good for

  • Front-end developers who add Hugeicons icons to React, Vue, Svelte, Angular, React Native or Flutter apps
  • Designers and developers who want the assistant to stop guessing icon names
  • Teams moving an existing project to Hugeicons

Works in

14 should work

Tap an app to see how to set it up and any known problems.

Install hugeicons MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the hugeicons MCP server to Claude Code. Run this command:
    
    claude mcp add --transport http hugeicons https://mcp.hugeicons.com/mcp
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

The hosted server has all 6 tools. The npm package (version 0.2.2) has 5 and no code-snippet tool. The plugin method bundles two Hugeicons skills with the hosted server.

From the project README. Source.

Tools

  • Finds icons by name or tag and gives their code names

    Looks up icons in the Hugeicons catalog. Exact name and tag matches come first. You can search several terms in one call by separating them with commas, and each result includes the name to use in JavaScript code.

    Try: “Find Hugeicons for home, notification and settings.”

    Network · search_icons

  • Gives the install command and code snippet for one icon (hosted server)

    Returns the install command, import line and usage snippet for one icon on a chosen platform and style, with the right export name. The hosted server and the current source have it. The published npm package, version 0.2.2, does not.

    Try: “Show me the React code for the home-01 icon.”

    Network · get_icon_code

  • Lists icon names page by page, optionally by category

    Browses the catalog in pages. The first page also lists every category with its icon count. Use search first when you know what the icon is for.

    Try: “List the icons in the e-commerce category.”

    Network · list_icons

  • Gives setup steps and component options for a framework

    Returns setup instructions and the component props for Hugeicons on one platform, such as React, Vue, Angular, Svelte, SolidJS, React Native, Flutter or plain HTML.

    Try: “How do I set up Hugeicons in a Flutter app?”

    Network · get_platform_usage

  • Gets an icon's font character in every style

    Returns the web font unicode character for one icon across all of its styles. Useful when you use the icon font rather than a component.

    Try: “Give me the font characters for the home-01 icon in all styles.”

    Network · get_icon_glyphs

  • Gets an icon's font character in one style

    Returns the web font unicode character for one icon in one style. Duotone and twotone icons also get a second character for their second layer.

    Try: “What is the stroke-rounded unicode for the settings icon?”

    Network · get_icon_glyph_by_style

Listed by the running server in our sandbox · 2026-11-02

Permissions

low risk · 3 things to watch

Low risk

Every tool only looks up icon information, and none can change files or accounts. Your search terms go to Hugeicons servers.

What it can do

Watch out for

  • The npm package sends your tool inputs and results to api.agnost.ai

    Version 0.2.2 wraps the server with the agnost analytics library and posts every tool call to api.agnost.ai: tool name, arguments (your search terms), results, latency and a session id. The code sets only the endpoint, so the library input and output opt-outs are left off, and no setting in the package turns it off. The icon catalog and glyphs come from hugeicons.com and api.hugeicons.com. The hosted server is a different build and does not use this package. npmjs.com

  • Search terms go to Hugeicons

    Icon names and search terms you ask for are sent to Hugeicons' servers. The tools only read icon data and change nothing. github.com

  • Self-hosted HTTP build listens on every interface

    If you run the HTTP version yourself, it binds 0.0.0.0 by default and has no sign-in. It serves public icon data only, but put it behind a proxy or set HOST to 127.0.0.1. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyEvery tool is annotated read-only in the README, so there is nothing to switch off.
Talks tomcp.hugeicons.com (hosted). hugeicons.com and api.hugeicons.com (npm package catalog and glyph lookups). api.agnost.ai (npm package 0.2.2: tool inputs, results and latency)
Sign-in and keysNo account, key or token for the hosted server or the npm package.

Questions

Is the Hugeicons MCP server official?

Yes. It is made by Hugeicons and lives in the company's own GitHub repository, under tools/mcp-server.

What is the Hugeicons MCP server URL?

https://mcp.hugeicons.com/mcp. It needs no sign-in, so add it as a custom connector in Claude, ChatGPT or Cursor, or use the command in the install box for Claude Code.

Is it free?

Yes, the server is free and needs no account. Only the stroke-rounded icon style is free, and the other styles need a Hugeicons Pro license.

Should I use the hosted server or the npm package?

Use the hosted address unless your app only supports local servers. The npm package (0.2.2) has 5 tools and no code-snippet tool, sends every tool call and result to api.agnost.ai with no off switch, and is older than the hosted server. The hosted server has 6 tools, which is why this page says 6.

Can it change my project or my icons?

No. Every tool is annotated read-only. It looks up icon names, code snippets, setup guides and font characters.

Is there a Claude Code plugin?

Yes. The project's Claude Code plugin bundles the server with two skills, one for using Hugeicons and one for migrating to it. Pick the plugin method on the Claude Code tab in the install box.

Which frameworks does it cover?

React, Vue, Angular, Svelte, SolidJS, React Native, Flutter and plain HTML with the icon font.

Does the server need Node.js?

Only for the local npm route. The hosted address needs nothing installed.

Information

updated Nov 2, 2026

Publisher
Official
Package
@hugeicons/mcp-server
Registry
npm
Transport
Streamable HTTP, stdio
Auth
None
Version
0.2.2
License
MIT
Last commit
Oct 31, 2026
Open issues
4

WebsiteGitHubnpmIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 5
  1. Hugeicons MCP server README · github.com
  2. Hugeicons repository README · github.com
  3. Hugeicons hosted MCP endpoint · mcp.hugeicons.com
  4. Hugeicons MCP server tool definitions · github.com
  5. @hugeicons/mcp-server on npm · npmjs.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.