# Iconoteka

> Iconoteka is an open-source MCP server for design and media. Search 1,400 open-source icons and get paste-ready SVG from your AI assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://iconoteka.com
- **Repository:** https://github.com/iconoteka/iconoteka/tree/HEAD/packages/iconoteka-mcp
- **MCP Registry name:** io.github.turbaba/iconoteka
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-15

## About

Instead of letting an assistant invent an SVG path, this server hands back the real icon from the Iconoteka library. Ask for a notification bell in medium weight and it returns the matching icon with ranked alternatives and keywords. The data ships inside the npm package, so it works offline.

Icons come in seven weights (thin to bold) and two styles (stroke and fill), drawn on a 24-point grid by Oleg Turbaba. The SVG uses currentColor so it follows the surrounding text colour. Everyday words such as trash, edit and settings resolve to the right icon, and if a variant does not exist, say a fill version of download, the server says which style to use instead.

Both the server and the icons are MIT licensed, free for commercial and closed-source use with no attribution required, though the name and logo are not covered. The README gives setup lines for Claude Code, Codex, VS Code, Cursor, Claude Desktop, Windsurf, Gemini CLI and Zed.

## Features

- **Search by meaning:** Finds icons by name or concept and shows their weights and styles.
- **Batch SVG fetch:** Request up to 24 icons in one call, such as a whole toolbar.
- **Seven weights, two styles:** Choose from thin to bold in stroke or fill.
- **Offline operation:** Icon data is bundled in the package.
- **Helpful fallbacks:** If a variant is missing, the reply suggests an available one.
- **23 categories:** Browse the library by category.

## Good for

- Add the right icon to a UI component without hunting through a website
- Generate a toolbar's icons in one request
- Match icon weight to a design system
- Find an icon for a concept like reminder or notification

## Install

### Claude Code (Terminal)

```sh
claude mcp add iconoteka -- npx -y iconoteka-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "iconoteka": {
      "command": "npx",
      "args": [
        "-y",
        "iconoteka-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "iconoteka": {
      "command": "npx",
      "args": [
        "-y",
        "iconoteka-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "iconoteka": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "iconoteka-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "iconoteka": {
      "command": "npx",
      "args": [
        "-y",
        "iconoteka-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "iconoteka": {
      "command": "npx",
      "args": [
        "-y",
        "iconoteka-mcp"
      ]
    }
  }
}
```

## Tools

- `search_icons`: Finds icons by meaning or name, with optional category and limit
- `get_icon`: Returns SVG markup for one or up to 24 icons by name, weight and style
- `list_categories`: Lists all 23 categories with icon counts

## FAQ

### How many icons are there?

1,400, in 7 weights and 2 styles.

### What licence applies?

MIT, for both the server and the icons, including commercial use.

### Does it need internet access?

No, the icon data ships inside the package.

### Which tools does it expose?

search_icons, get_icon and list_categories.

### Is Iconoteka free?

Yes. Iconoteka is open source, so you can use and self-host it for free.

### How do I add Iconoteka to Claude Code?

Run this command in your terminal: claude mcp add iconoteka -- npx -y iconoteka-mcp

### What are the best alternatives to Iconoteka?

The closest alternatives to Iconoteka are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/iconoteka
