AI Integration

Install the Nucleo MCP server and agent skills so your AI coding tool can search your licensed icon families, insert React components or SVGs, and customize icons, all from the chat.

What you can do #

Once installed, ask your AI tool naturally. Typical requests:

• Search icons by name or idea across your families (core, ui, sharp, micro, pixel)
• Pick a family, style (outline, glyph, outline duo…), and size when it matters
• Get the right React component or SVG for your project
• Customize icons (color, secondary color, stroke width, duo opacity, corners)

Install with the CLI #

Recommended if you use Cursor, Claude Code, or Codex. Requires Node.js 20+.

npx @nucleoicons/skills setup --target react --tools cursor

Required flags:

• --target: react or vanilla
• --tools: one or more of cursor, claude, codex

npx @nucleoicons/skills setup --target react --tools cursor
npx @nucleoicons/skills setup --target vanilla --tools cursor,claude

Setup signs you in with your Nucleo account, downloads your licensed package to ~/.nucleo/skills, and configures the editors you choose (skills + MCP). Then reload MCP in your editor.

Supported editors #

How to use it #

After setup, reload MCP and ask something like:

What Nucleo icon families do I have?

More examples:

• “Find a settings icon in Nucleo UI”
• “Insert the home icon as a React component”
• “Search for a folder icon in core outline 24”
• “Use the sharp version of that icon”
• “Make the stroke thicker” / “change the secondary color”

Update #

When we release new icons or package fixes:

npx @nucleoicons/skills update
npx @nucleoicons/skills update --check

After updating, reload MCP again.

Using a different AI tool #

If you use an editor that isn’t Cursor, Claude Code, or Codex, download the MCP + skills zip packages from your account instead of (or in addition to) the CLI.

1. Go to Source Files while signed in
2. Under Nucleo Skills / MCP, download the React or Vanilla SVG packages for your license
3. Full-library users get one bundle zip; partial licenses get shared (MCP + skills) plus each licensed family
4. Unpack the zips into one folder, then point your tool’s MCP config at the mcp/dist/index.js entry and load the skills/ folders

Set NUCLEO_SKILLS_ROOT to that install folder so the MCP can find your icons. The exact MCP config format depends on your tool.

Go to Source Files →