# iconmind

An MCP server that searches IconMind icons by name, tag, alias, or category and returns usable slugs and import lines. It runs offline.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Author: Iconmind
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Iconmind/iconmind/tree/HEAD/packages/mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/iconmind

## What it does

iconmind gives an AI coding assistant access to the IconMind MIT icon set. It can look up an icon by name, tag, alias, or category, then return the matching slug and an import line for use in a UI. This avoids relying on guessed icon names.

In Claude Code, add the server with `claude mcp add iconmind -- npx -y @iconmind/mcp`. The icon data ships inside the package, so searches work offline. The same server is also listed for Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, and Gemini CLI.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add iconmind -- npx -y @iconmind/mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add mcp -- npx -y @iconmind/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@iconmind/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@iconmind/mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcp npx -y @iconmind/mcp
```

## When to use it
- find an icon by name or tag
- search the icon set by category
- get the correct slug and import line
- check an icon name before building a UI

## Example prompts
- Find a settings icon by tag and return its slug plus the import line.
- Search the navigation category and show icons that fit this interface.
- Check whether this icon name exists and give me the correct import line.

## Similar
- [better-icons](https://affpapa.org/en/nevibecode/skills/better-icons.md) — skill · 5900 installs
- [suggest-icon](https://affpapa.org/en/nevibecode/skills/suggest-icon.md) — skill · 551 installs
- [Svg/icons MCP](https://affpapa.org/en/nevibecode/mcp/svgicons-mcp.md) — MCP server
- [make-interfaces-feel-better](https://affpapa.org/en/nevibecode/skills/make-interfaces-feel-better.md) — skill · 73400 installs
- [icon-set-generator](https://affpapa.org/en/nevibecode/skills/icon-set-generator.md) — skill · 1900 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md