@iconaut/mcp

An MCP server for the 1,263 free Iconaut icons. It lets a coding agent look an icon up instead of guessing its name, and hands back the exact SVG, the iconaut-react import and the shadcn/ui command.

Everything runs locally from data bundled in the package: no network, no account, no API key.

Set up

Claude Code:

claude mcp add iconaut -- npx -y @iconaut/mcp

Cursor, Windsurf, Claude Desktop and other clients take the same command in their MCP config:

{
  "mcpServers": {
    "iconaut": { "command": "npx", "args": ["-y", "@iconaut/mcp"] }
  }
}

Tools

| Tool | What it does | |---|---| | search_icons | Search by name, keyword or meaning ("settings", "arrow left", "delete"). Filter by category or style. | | get_icon | One icon by name: the SVG at 16, 20 or 24px in line, solid or duo, the React import, the shadcn command and the CDN URL. | | list_categories | The 27 categories and how many icons each holds. |

Tuned for each size

16, 20 and 24 are native sizes, each with its own stroke weight, so get_icon takes the size the icon will be shown at. 16 also gets a simplified drawing that drops fine detail; 20 and 24 share the full drawing:

| size | drawing | stroke | |---|---|---| | 16 | compact | 1.25 | | 20 | default | 1.5 | | 24 | default | 1.75 |

What is in here

The free, MIT-licensed set only: the same icons as iconaut-react and github.com/iconaut-design/icons, at the same version. The Pro packs live in the Figma plugin.

Browse the set at iconaut.design/icons.