Skip to content
MCP server

Iconoteka

Search 1,400 open-source icons and get paste-ready SVG from your AI assistant

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.2.3
Listing updated
1 day ago

About Iconoteka

Iconoteka is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add iconoteka -- npx -y iconoteka-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "iconoteka": {
      "command": "npx",
      "args": [
        "-y",
        "iconoteka-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "iconoteka": {
      "command": "npx",
      "args": [
        "-y",
        "iconoteka-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Free, MIT licensed; donations via Patreon or Ko-fi

Prices change. Check iconoteka.com before you buy.

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory