coolicons — Claude Code MCP server: icon search and setup
The coolicons MCP server for Claude Code searches icons by meaning and returns SVGs and import code, helping an agent choose an interface icon.
MIT ★ 498 updated 2026-10-29
claude mcp add coolicons -- npx -y @coolicons/mcpWhat coolicons does
coolicons gives an agent MCP tools for exploring an icon set. It can search by name or meaning, then return an SVG with a selected style, corner radius, size, and stroke width. When a search term is misspelled, the server suggests nearby names.
The set includes five styles and three corner radii. describe_set reports categories and naming rules; search_icons finds entries; get_icon returns SVG; and get_usage provides install and import code. Import options cover React, Vue, plain SVG, and the shadcn/ui registry. The package contains the icon set, so no API key or network connection is required. Names that collide with JavaScript or browser globals gain an Icon suffix, such as MapIcon.
For Claude Code, run the package through npx using the command below. The server also supports Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, and Gemini CLI.
What it helps with
- find an icon from a description of its meaning
- retrieve an SVG with a chosen style and corner radius
- get import code for React or Vue
- resolve a misspelled icon name using nearby matches
Example prompts for the agent
- Find an icon for closing a dialog and return its SVG.
- Look up a search icon and give me the React import code.
- Show the available matches for
mapand return an SVG in the selected style.
How to install coolicons
Platform CLI
claude mcp add coolicons -- npx -y @coolicons/mcpPlatform CLI
codex mcp add mcp -- npx -y @coolicons/mcpConfig file
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@coolicons/mcp"
]
}
}
}Config file
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@coolicons/mcp"
]
}
}
}Platform CLI
gemini mcp add mcp npx -y @coolicons/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about coolicons
How do I install coolicons in Claude Code?
Run claude mcp add coolicons -- npx -y @coolicons/mcp to add the MCP server through npx.
What does coolicons do?
It lets an agent search icons by name or meaning, retrieve SVG source, and view import code.
Does coolicons require an API key?
No. The icon set is bundled with the package, and the server works without a network connection.