# Hugeicons (free set) — card for AI agents

6,000+ free Stroke Rounded icons under MIT (as reported) plus a paid Pro set; npm packages and a free hosted MCP server.

Category: Icons · maker Hugeicons · checked 2026-11-05 · style: outline, minimal

## Price
- Price: Free tier
- Free tier: Free Stroke Rounded set (MIT); MCP server free; Pro styles paid (as reported).
- Pricing page: https://hugeicons.com/pricing

## License
MIT (free icons); Hugeicons Pro license for Pro — https://hugeicons.com/license-agreement

- commercial: **yes** (Commercial use OK)
  > You may use, copy, modify, publish and distribute them, for personal or commercial purposes, provided you keep the MIT copyright and permission notice with any copy of the source files.
  (https://hugeicons.com/license-agreement)
- attribution: **no** (No credit needed)
  > provided you keep the MIT copyright and permission notice with any copy of the source files.
  (https://hugeicons.com/license-agreement)
- in app: **yes** (Can ship inside your app)
  > Use, modify and redistribute them anywhere, for anything, free of charge.
  (https://hugeicons.com/license-agreement)
- redistribute: **yes** (Can pass the files on to your own users)
  > Use, modify and redistribute them anywhere, for anything, free of charge.
  (https://hugeicons.com/license-agreement)

## Rules to follow
- Use only the free Stroke Rounded style unless the user has Pro
- Keep the MIT notice with copied source files
- Pro icon source files may not be redistributed

## Can an AI agent use it by itself?
**Yes** · free-api: Agent calls a free official API or MCP

## How an agent gets files
- Connect the free MCP server https://mcp.hugeicons.com/mcp (no key; 300 requests/min per IP) or npm install @hugeicons/core-free-icons @hugeicons/react. (sign-in: none)
- Formats: svg, jsx
- Not allowed: Pro styles need a paid license
- Not allowed: MCP rate limit 300/min per IP

## How to connect
- Official MCP server
- MCP server (official): https://mcp.hugeicons.com/mcp
- npm: `npm install @hugeicons/core-free-icons`
- Repository: https://github.com/hugeicons/hugeicons
- Website: https://hugeicons.com

## Notes
Official Claude plugin: "claude plugin marketplace add hugeicons/hugeicons". Agents default to the free set per the vendor.

## Numbers (AgentGid data)
- Gid Score: 43
- GitHub stars: 1,235
- Downloads last week: 1,933,669
- Used in 12 public projects set up for AI coding agents

## Lines to paste into your prompt or AGENTS.md

```
- Hugeicons (free set) (Icons). 6,000+ free Stroke Rounded icons under MIT (as reported) plus a paid Pro set; npm packages and a free hosted MCP server. Price: free tier; commercial use OK; no credit needed. Style: outline, minimal.
  Connect: official MCP server https://mcp.hugeicons.com/mcp; npm @hugeicons/core-free-icons.
  Get files: Connect the free MCP server https://mcp.hugeicons.com/mcp (no key; 300 requests/min per IP) or npm install @hugeicons/core-free-icons @hugeicons/react (svg, jsx).
  Not allowed: Pro styles need a paid license
  Not allowed: MCP rate limit 300/min per IP
  Rule: Use only the free Stroke Rounded style unless the user has Pro
  Rule: Keep the MIT notice with copied source files
  Rule: Pro icon source files may not be redistributed
  License: https://hugeicons.com/license-agreement (checked 2026-11-05; details: https://agentgid.com/assets/hugeicons/)
```

## Links
- AgentGid page: https://agentgid.com/assets/hugeicons/
- Is it free for commercial use? https://agentgid.com/assets/hugeicons/commercial-use/
- Source: https://hugeicons.com
- Source: https://hugeicons.com/license-agreement
- Source: https://hugeicons.com/ai-agents
- Source: https://raw.githubusercontent.com/hugeicons/hugeicons/HEAD/packages/core-free-icons/LICENSE.md


## Hugeicons: free rounded line icons for apps

Hugeicons gives you a free set of more than 6,000 icons, like a house, a wallet or a bell, all drawn in one soft rounded line style. You or your AI assistant add them to a website or app, and you can use them in paid products. A larger paid Pro set exists; this page covers only the free set.

### Where to use it
- Menus and buttons in a React app: Each icon is its own piece you place on a screen, such as a bell for notifications. You set its size, color and line thickness, and only the icons you use end up in the app.
- Icons on a plain web page: A simple site without a framework adds one style line in the page head and then writes one short tag per icon.
- A money or banking dashboard: Wallet, transfer, invoice and settings icons for a finance screen, all in the same style. The vendor lists this as a ready prompt for an AI assistant.
- Tab bars in phone apps: The same icons work in React Native and Flutter apps, for example the Home, Search and Profile tabs at the bottom of the screen.
- Your AI assistant finds the right icon: A free hosted search lets your AI assistant look up real icon names and the exact code for them, instead of guessing names that do not exist.
- Icons as plain image files: Turn icons into small image files for emails, slides or a page made on a server, without any script running in the browser. (idea, not from the official pages)

### How to start
- Install the React part and the free icon pack (there are also packages for Vue, Svelte, SolidJS, Angular, React Native and Flutter).

```
npm i @hugeicons/react @hugeicons/core-free-icons
```

- Import the icon component and an icon by name, then set size, color and line thickness.

```
import { HugeiconsIcon } from '@hugeicons/react'
import { Notification03Icon } from '@hugeicons/core-free-icons'

function App () {
  return <HugeiconsIcon icon={Notification03Icon} size={24} color="currentColor" strokeWidth={1.5} />
}
```

- On a page without a framework, add the icon font link to the page head and use i tags.

```
<link rel="stylesheet" href="https://use.hugeicons.com/font/icons.css" />
```


### License
The free icons can be used in personal and paid products, changed and passed on, with no visible credit. Keep the short MIT notice with copies of the files. Pro icons are a separate paid product and their files may not be shared.

### Good to know
- The free set has one style only: rounded lines. Filled, two-tone and other styles are in the paid Pro set.
- The free icons need no account, no key and no seat; those apply to Pro only.
- The hosted icon search for AI assistants is free and needs no key, but it allows 300 requests per minute from one address.
- The old icon font address on cdn.hugeicons.com is frozen and gets no new icons; link the new address instead.
- Screen readers need a label on buttons that show only an icon, such as a trash can for Delete.

Checked 2026-11-09 against: https://hugeicons.com, https://hugeicons.com/license-agreement, https://hugeicons.com/ai-agents, https://hugeicons.com/pricing, https://hugeicons.com/docs, https://hugeicons.com/docs/integrations/react/quick-start, https://hugeicons.com/docs/integrations/react/best-practices, https://hugeicons.com/docs/icons-for-web/quick-start, https://hugeicons.com/docs/faqs/license-questions, https://hugeicons.com/docs/integrations/mcp, https://github.com/hugeicons/hugeicons/blob/main/README.md, https://raw.githubusercontent.com/hugeicons/hugeicons/HEAD/packages/core-free-icons/LICENSE.md, https://registry.npmjs.org/@hugeicons/core-free-icons/4.4.0, https://registry.npmjs.org/@hugeicons/react/1.1.10

### Mistakes to avoid
- Don't: import { SearchIcon } from '@hugeicons-pro/core-stroke-rounded' in a project without a Pro license → Do: import { SearchIcon } from '@hugeicons/core-free-icons' (Pro packages are a paid product that needs a license key; the free pack is the MIT one.)
- Don't: npm install @hugeicons/react alone, or <HugeiconsIcon icon="search" /> → Do: Install both @hugeicons/react and @hugeicons/core-free-icons and pass the imported icon object, icon={SearchIcon} (The React package only draws icons; the icons themselves come from a separate pack.)
- Don't: Guessing export names from the icon name, such as TwoBracketIcon for 2nd-bracket → Do: Look the name up (the search on hugeicons.com, the get_icon_code tool, or the installed package's type files) (Export names do not follow the icon names in a predictable way, so guessed imports fail.)
- Don't: import * as Icons from '@hugeicons/core-free-icons' → Do: import { Notification03Icon, SearchIcon } from '@hugeicons/core-free-icons' (A wildcard import keeps every icon in the app; named imports keep only the ones used.)
- Don't: <link rel="stylesheet" href="https://cdn.hugeicons.com/font/hgi-stroke-rounded.css"> → Do: <link rel="stylesheet" href="https://use.hugeicons.com/font/icons.css" /> (The old address is frozen and gets no new icons or fixes; the class names stay the same.)

### Questions
- Can I use the free Hugeicons in a paid app? Yes. The free icons are under the MIT License for personal and commercial use; keep the MIT notice with copies of the files.
- Do I need an account or a license key for the free icons? No. Seats and license keys are only for the paid Pro icons.
- Can I put the free icons in an open-source project or a template I give away? Yes for the free icons; the license page itself points to them for downloadable or open-source work. Pro icon files may not be passed on.
- Will an AI assistant use paid Pro icons by mistake? The vendor's assistant tools use the free style unless the project already has Pro packages or you ask for Pro.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
