# Iconify — card for AI agents

300k+ open-source icons from 200+ sets via a free public API and the @iconify/json package.

Category: Icons · maker Iconify OU · checked 2026-10-23

## Price
- Price: Free
- Free tier: Public API free; the API is open source and self-hostable.

## License
API code Apache-2.0; icons per set (MIT, Apache-2.0, ISC, CC BY 4.0, CC BY-SA 4.0, GPL, OFL...) — https://github.com/iconify/icon-sets/blob/master/collections.md

- commercial: **conditions** (Commercial use with conditions)
  > This license does not apply to icons. Icon sets use various open source licenses, see each icon set for details.
  (https://iconify.design/)
- attribution: **varies** (Credit depends on the item)
- in app: **conditions** (Ship inside your app with conditions)
  > This license does not apply to icons. Icon sets use various open source licenses, see each icon set for details.
  (https://iconify.design/)

## Rules to follow
- Check each icon set's license; some need attribution (CC BY) or are copyleft (GPL, CC BY-SA).
- Self-host the API for heavy traffic instead of loading the public servers.

## Can an AI agent use it by itself?
**Yes** · package: Agent installs a package or loads it from a CDN

## How an agent gets files
- Public Iconify API (docs at iconify.design/docs/api/), npm @iconify/json, or self-host the API (GitHub, NPM, Docker). (sign-in: none)
- Formats: svg
- Not allowed: Check each icon set's license in collections.md; sets use MIT, Apache 2.0, ISC, CC BY 4.0, CC BY-SA 4.0, OFL, GPL and others
- Not allowed: Public API has limits to prevent abuse; self-host for heavy traffic

## React (official example, https://iconify.design/docs/icon-components/react/)

```
npm install --save-dev @iconify/react

import { Icon } from "@iconify/react";

<Icon icon="mdi:home" style={{ color: "red" }} />
```

## How to connect
- Public API + community MCP
- MCP server (community): glama.ai/mcp/servers/Osmansiddiquer/iconify-mcp
- API docs: https://iconify.design/docs/api/
- API limits: No published rate limit; one icon set per query; servers are free but cost money to run.
- npm: `npm install @iconify/json`
- Repository: https://github.com/iconify/icon-sets
- Website: https://iconify.design

## Notes
Updates of Figma-sourced sets stopped on 26 Nov 2025 due to Figma API limits.

## Numbers (AgentGid data)
- Gid Score: 34
- GitHub stars: 1,086
- Downloads last week: 388,936
- Used in 11 public projects set up for AI coding agents

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

```
- Iconify (Icons). 300k+ open-source icons from 200+ sets via a free public API and the @iconify/json package. Price: free; commercial use with conditions; credit depends on the item; ship inside your app with conditions.
  Connect: community MCP server glama.ai/mcp/servers/Osmansiddiquer/iconify-mcp; API docs https://iconify.design/docs/api/; npm @iconify/json. Limits: No published rate limit; one icon set per query; servers are free but cost money to run.
  Get files: Public Iconify API (docs at iconify.design/docs/api/), npm @iconify/json, or self-host the API (GitHub, NPM, Docker) (svg).
  Not allowed: Check each icon set's license in collections.md; sets use MIT, Apache 2.0, ISC, CC BY 4.0, CC BY-SA 4.0, OFL, GPL and others
  Not allowed: Public API has limits to prevent abuse; self-host for heavy traffic
  Rule: Check each icon set's license; some need attribution (CC BY) or are copyleft (GPL, CC BY-SA).
  Rule: Self-host the API for heavy traffic instead of loading the public servers.
  License: https://github.com/iconify/icon-sets/blob/master/collections.md (checked 2026-10-23; details: https://agentgid.com/assets/iconify/)
```

## Links
- AgentGid page: https://agentgid.com/assets/iconify/
- Is it free for commercial use? https://agentgid.com/assets/iconify/commercial-use/
- Source: https://iconify.design/docs/api/
- Source: https://github.com/iconify/icon-sets
- Source: https://github.com/iconify/icon-sets/blob/master/collections.md
- Source: https://iconify.design/news/2025.html
- Source: https://iconify.design/


## Iconify: one way to use 200+ free icon sets

Iconify gathers more than 200 free icon sets, such as Material, Tabler and Phosphor, behind one naming scheme like "mdi:home". You or your AI assistant can mix icons from different sets in the same site, from a free public icon service or from files kept in your own project. Each set keeps its own license, so you check that before shipping.

### Where to use it
- Icons in a React or Vue app: Write the icon name, such as "mdi:home", and the component shows it. You are not limited to one style, because every set uses the same name format.
- Icons that work without the internet: Keep the icons you use inside your own project, so pages show them even if the public icon service is slow or down.
- Icons in Tailwind class names: In a Tailwind project, write an icon as a class like icon-[mdi-light--home] and it is built into your styles, with no script on the page.
- An icon link for emails or plain pages: Put an icon into an image tag or a style rule with a plain link, without installing anything. Good for quick pages and prototypes.
- An icon picker in a site builder: Let your users search and pick any of the icons for their own pages, using the search that comes with the icon service.
- Flags and colorful emoji next to line icons: Add country flags to a language menu or color emoji to a chat, with the same naming as your menu icons. (idea, not from the official pages)

### How to start
- Pick icons on the Iconify site; each icon has a name made of the set prefix and the icon name, such as mdi-light:home.
- For any page or framework, load the iconify-icon web component and write one tag per icon.

```
<iconify-icon icon="mdi:home"></iconify-icon>
```

- To avoid the public service, install only the sets you use as @iconify-json packages and hand their data to the component or a build plugin.

```
npm i -D @iconify-json/mdi-light
```


### License
Iconify's own code is free open source. The icons are not under one license; every set has its own. Most are free for paid products, but some need a credit, some force the same license on changes, and one bans commercial use.

### Good to know
- Check the license of each set you use in the official list. Sets come under MIT, Apache 2.0, ISC, CC0, CC BY, CC BY-SA, OFL and GPL.
- By default the components load each icon from Iconify's public servers. They are free, but limited to prevent abuse. Host your own copy for heavy use.
- The all-in-one package with every set is very large. Install single sets instead, one small package per set.
- Sets that Iconify copied from Figma files stopped getting updates in November 2025 because of Figma's request limits.
- In Next.js the React icon component draws icons only in the browser, after a short delay. The docs suggest the web component there.

Checked 2026-11-09 against: https://iconify.design/, https://iconify.design/docs/, https://iconify.design/docs/api/, https://iconify.design/docs/api/hosting.html, https://iconify.design/docs/api/queries.html, https://iconify.design/docs/api/svg.html, https://iconify.design/docs/api/providers.html, https://iconify.design/docs/icons/, https://iconify.design/docs/icons/icon-data.html, https://iconify.design/docs/icons/all.html, https://iconify.design/docs/usage/, https://iconify.design/docs/usage/css/, https://iconify.design/docs/usage/svg/, https://iconify.design/docs/usage/css/tailwind/tailwind4/, https://iconify.design/docs/icon-components/, https://iconify.design/docs/icon-components/react/, https://iconify.design/docs/iconify-icon/, https://iconify.design/docs/iconify-icon/add-collection.html, https://iconify.design/docs/libraries/utils/, https://iconify.design/docs/types/iconify-json.html, https://iconify.design/news/2025.html, https://iconify.design/privacy/, https://github.com/iconify/icon-sets/blob/master/collections.md, https://registry.npmjs.org/@iconify/json/latest, https://registry.npmjs.org/iconify-icon/3.0.5, https://registry.npmjs.org/@iconify/react/6.0.4

### Mistakes to avoid
- Don't: Mixing icons from any set because "Iconify is open source" → Do: Look up each prefix in collections.md (or info.json in its @iconify-json package) and keep to sets whose license fits; add credits for CC BY sets (Iconify's license covers its code only; icon sets carry MIT, Apache, CC BY, CC BY-SA, GPL and even a non-commercial license.)
- Don't: Shipping a busy production site that loads every icon from api.iconify.design → Do: Bundle the icons (@iconify-json/* with addCollection, unplugin-icons or the Tailwind plugin) or host your own API (The public servers have abuse limits and their main job is serving icon components; every visitor's browser also contacts them.)
- Don't: npm install @iconify/json just to use a few icons → Do: npm install the single set, such as @iconify-json/tabler (The big package holds every set (over 600 MB unpacked for version 2.2.554, per its npm registry entry) and is updated every few days.)
- Don't: <iconify-icon className="..."> in React, or using it in Nuxt with no config → Do: Use class (or the React wrapper); in Nuxt mark iconify-icon as a custom element (The web component works in React and Next with small differences, and Nuxt must be told it is a web component.)
- Don't: Expecting icons added with addCollection to stay after a reload → Do: Call addCollection on every page load before the icons render (Icons added by hand are kept only in memory; only icons fetched from the API are cached.)

### Questions
- Can I use Iconify icons in a paid app? It depends on the set. Iconify's code is open source, but the icons keep the license of their own set, which you check in the official list before use.
- Do my visitors' browsers contact Iconify? Yes with the default components, which load icon data from the public servers on demand. No if you give the component the icon data yourself or build icons into your CSS.
- Can I run my own icon server? Yes. The icon server is open source and can run on your machine, from a package or in Docker, with only the sets you choose.
- Is there a cost? The public servers are free to use; the project asks heavy users to consider supporting it, since running servers costs money.

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