Hugeicons MCP Server: Setup for Claude Code, Cursor and Other Apps
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.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports hosted MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports hosted MCP servers.
Install hugeicons MCP
Claude Code
- 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
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_iconsGives 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_codeLists 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_iconsGives 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_usageGets 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_glyphsGets 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
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
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-only | Every tool is annotated read-only in the README, so there is nothing to switch off. |
|---|---|
| Talks to | mcp.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 keys | No 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
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 5Hide
- Hugeicons MCP server README · github.com
- Hugeicons repository README · github.com
- Hugeicons hosted MCP endpoint · mcp.hugeicons.com
- Hugeicons MCP server tool definitions · github.com
- @hugeicons/mcp-server on npm · npmjs.com