# Iconoteka

Gives your assistant a catalog of 1,400 icons across 7 weights and 2 styles, and hands back real SVG markup instead of a guessed path.

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

## What it does

An assistant asked for an icon usually improvises the path. This server makes it look the icon up and return the actual markup. Everything runs offline, because the icon data ships inside the npm package.

Three tools come with it. `search_icons` matches on meaning or name and reports which weights and styles an icon has, along with its other keywords. `get_icon` returns markup for one icon or for a batch — up to 24 in a single call, which covers a whole toolbar. `list_categories` lists 23 categories with icon counts.

Weight is set with `weight`: `thin`, `ultralight`, `light`, `regular`, `medium`, `semibold`, `bold`, and `regular` applies when you leave it out. Style takes `stroke` or `fill`, `stroke` being the default. Most icons carry all 14 variants; a few have 7 or 8. Ask for a variant that does not exist and the server tells you what to use instead. The path uses `currentColor`, so an icon picks up the text colour around it. MIT covers both the server and the icons, closed-source projects included; the Iconoteka name and logo sit outside that grant.

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

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add iconoteka -- npx -y iconoteka-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add iconoteka-mcp -- npx -y iconoteka-mcp
```

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add iconoteka-mcp npx -y iconoteka-mcp
```

## When to use it
- drop an icon into a UI without hand-writing the path
- fetch SVG for a full button row in one request
- find an icon by meaning rather than exact name
- pick the right weight and style for a layout
- see which icon categories the set contains

## Example prompts
- Find a notification bell icon in medium weight
- Give me the SVG for `bell`, `trash` and `pen` in stroke style
- What icon categories does Iconoteka have?

## Similar
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [tldraw](https://affpapa.org/en/nevibecode/mcp/tldraw.md) — MCP server · ★ 51091
- [Figma-Context-MCP](https://affpapa.org/en/nevibecode/mcp/figma-context-mcp.md) — MCP server · ★ 16062
- [mcp-server-chart](https://affpapa.org/en/nevibecode/mcp/mcp-server-chart.md) — MCP server · ★ 4402
- [Dembrandt](https://affpapa.org/en/nevibecode/mcp/dembrandt.md) — MCP server · ★ 3821
- [RevoGrid DataGrid MCP Pro](https://affpapa.org/en/nevibecode/mcp/revogrid-datagrid-mcp-pro.md) — MCP server · ★ 3450

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