Iconoteka
Search 1,400 open-source icons and get paste-ready SVG from your AI assistant
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"iconoteka": {
"command": "npx",
"args": [
"-y",
"iconoteka-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"iconoteka": {
"command": "npx",
"args": [
"-y",
"iconoteka-mcp"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory