# MingCute Icons — card for AI agents

Open-source set of 2,263 icons in Core Regular and Core Filled styles (4,526 SVGs, as reported in the README) as SVG, icon font and React/Vue packages.

Category: Icons · maker MingCute Design · checked 2026-11-09 · style: outline, flat, minimal

## Price
- Price: Free
- Free tier: Fully free.

## License
Apache-2.0 — https://raw.githubusercontent.com/mingcute-design/mingcute-icons/main/LICENSE

- commercial: **yes** (Commercial use OK)
  > each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
  (https://raw.githubusercontent.com/mingcute-design/mingcute-icons/main/LICENSE)
- attribution: **no** (No credit needed)
  > You must give any other recipients of the Work or Derivative Works a copy of this License
  (https://raw.githubusercontent.com/mingcute-design/mingcute-icons/main/LICENSE)
- in app: **yes** (Can ship inside your app)
  > each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
  (https://raw.githubusercontent.com/mingcute-design/mingcute-icons/main/LICENSE)
- redistribute: **yes** (Can pass the files on to your own users)
  > each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
  (https://raw.githubusercontent.com/mingcute-design/mingcute-icons/main/LICENSE)

## Rules to follow
- Keep the Apache-2.0 license with redistributed files
- Old package mingcute_icon moved to @mingcute/svg and @mingcute/font

## 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
- npm install @mingcute/react (or @mingcute/svg / @mingcute/font). No account. (sign-in: none)
- Formats: svg, jsx, woff2
- Not allowed: Apache-2.0 notice

## How to connect
- Official MCP server
- npm: `npm install @mingcute/react`
- Repository: https://github.com/mingcute-design/mingcute-icons
- Website: https://www.mingcute.com

## Notes
Official MCP server @mingcute/mcp-server (local stdio via npx; searches the bundled free catalogue without an account).

## Numbers (AgentGid data)
- Gid Score: 27
- GitHub stars: 1,657
- Downloads last week: 11,291

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

```
- MingCute Icons (Icons). Open-source set of 2,263 icons in Core Regular and Core Filled styles (4,526 SVGs, as reported in the README) as SVG, icon font and React/Vue packages. Price: free; commercial use OK; no credit needed. Style: outline, flat, minimal.
  Connect: npm @mingcute/react.
  Get files: npm install @mingcute/react (or @mingcute/svg / @mingcute/font). No account (svg, jsx, woff2).
  Not allowed: Apache-2.0 notice
  Rule: Keep the Apache-2.0 license with redistributed files
  Rule: Old package mingcute_icon moved to @mingcute/svg and @mingcute/font
  License: https://raw.githubusercontent.com/mingcute-design/mingcute-icons/main/LICENSE (checked 2026-11-09; details: https://agentgid.com/assets/mingcute-icons/)
```

## Links
- AgentGid page: https://agentgid.com/assets/mingcute-icons/
- Is it free for commercial use? https://agentgid.com/assets/mingcute-icons/commercial-use/
- Source: https://www.mingcute.com
- Source: https://github.com/mingcute-design/mingcute-icons
- Source: https://raw.githubusercontent.com/mingcute-design/mingcute-icons/main/LICENSE


## MingCute Icons: rounded icons in outline and filled

MingCute Icons is a free set of a little over two thousand rounded icons, each drawn twice, as an outline and as a filled shape. You or your AI assistant add them to a website or app as ready pieces for React, Vue and other tools, or as plain picture files. They are free for paid products too.

### Where to use it
- Tab bars with an active state: Show the outline icon for the tabs you are not on and the filled one for the current tab, so people see at once where they are. (idea, not from the official pages)
- Menus and links in a React app: Each icon is its own small piece you put next to a menu item or inside a button, such as a house next to Home.
- Icons in Vue, Svelte or mobile apps: The same icons come as ready pieces for Vue, Svelte, SolidJS and React Native, so a web app and a phone app can share one look.
- Icon files on a simple website: Copy the icon files into your site and use them as images or backgrounds, on pages built without any framework.
- Icons in a content editor or old template: Add an icon with one class name through the icon font, for example in a CMS template where you cannot add code.
- Settings and account screens: Give each settings row its own icon: notifications, dark mode, language, billing, privacy. The list reads faster and looks tidy. (idea, not from the official pages)

### How to start
- Install the package for your framework (React shown; Vue, Svelte, SolidJS, React Native, plain JavaScript, SVG files and an icon font also exist).

```
npm install @mingcute/react
```

- Import an icon from the style folder (core-regular or core-filled) and place it.

```
import { Home1Regular } from '@mingcute/react/core-regular';

export function HomeIcon() {
  return <Home1Regular size={24} title="Home" />;
}
```


### License
Apache 2.0 license: free in personal and paid products, with no visible credit needed. When you pass the icon files on, include a copy of the license.

### Good to know
- The free set has two styles, outline and filled. The Cute and Sharp styles belong to the paid Pro version with its own license.
- Version 3 renamed many icons and dropped old names, and the old mingcute_icon package is retired. Code written for version 2 needs new names.
- The React pieces need React 18 or 19; the Vue ones need Vue 3.5 or newer.
- No account is needed for the free packages. The Pro packages need a paid plan and a private download setup.
- The icon font cannot show every detail, such as gradients or brand colors; use the picture files or ready pieces for those.

Checked 2026-11-09 against: https://www.mingcute.com, https://github.com/mingcute-design/mingcute-icons, https://github.com/mingcute-design/mingcute-icons/blob/main/README.md, https://github.com/mingcute-design/mingcute-icons/blob/main/LICENSE, https://github.com/mingcute-design/mingcute-icons/blob/main/CHANGELOG.md, https://github.com/mingcute-design/mingcute-icons/blob/main/release.json, https://github.com/mingcute-design/mingcute-icons/blob/main/packages/svg/README.md, https://github.com/mingcute-design/mingcute-icons/blob/main/packages/react/README.md, https://registry.npmjs.org/@mingcute/react, https://registry.npmjs.org/@mingcute/react/3.1.0, https://registry.npmjs.org/@mingcute/svg/3.1.0, https://registry.npmjs.org/@mingcute/font, https://registry.npmjs.org/@mingcute/vue, https://registry.npmjs.org/mingcute_icon, https://registry.npmjs.org/@mingcute/mcp-server/0.2.0

### Mistakes to avoid
- Don't: npm install mingcute_icon → Do: npm install @mingcute/svg or @mingcute/font (or the framework package such as @mingcute/react) (The old package is retired and points to the new ones.)
- Don't: import { Home1Regular } from '@mingcute/react' → Do: import { Home1Regular } from '@mingcute/react/core-regular' (or the direct path '@mingcute/react/core-regular/home-1') (The package root holds only shared helpers and types, not the icons.)
- Don't: Icon names from version 2, such as docment or barcode-sca, or the old class names → Do: Look up current names in the 3.x package (e.g. document, barcode-scan) or the icon mapping file (Version 3.1.0 uses new names without aliases for the old ones.)
- Don't: <img src="/node_modules/@mingcute/svg/core-regular/home-1.svg"> → Do: Copy the files you use into the site's public folder during the build, or import them through the bundler (The docs say not to serve package files straight from node_modules.)
- Don't: <button><MenuRegular /></button> with no name → Do: <button type="button" aria-label="Open navigation"><MenuRegular size={20} aria-hidden="true" /></button> (Icons are decorative by default, so an icon-only button needs its own accessible name.)

### Questions
- Can I use MingCute icons in a paid app or client project? Yes. The Apache License 2.0 grants a free, worldwide license to copy, show and distribute the icons; pass on a copy of the license with the files.
- What is the difference between Regular and Filled? They are the same 2,263 icons drawn as outlines (Core Regular, a 2 px line) and as solid shapes (Core Filled).
- Can I change size and color? Yes. Components take size (default 24) and color (default the text color); the plain files use the text color too.
- Where can I search the icons? On the MingCute website, which also lets you preview, recolor and download single icons; there is a Figma plugin too.
- Is there a tool for AI coding assistants? Yes. The project publishes an MCP server on npm for searching and using the icons from an assistant.

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