Icon MCP server

icon-mcp

mcp-name: io.github.pratham-jain33/icon-mcp

Give any AI assistant a custom icon button. No emojis, no designer needed.

Unofficial community project. Not made by, endorsed by, or affiliated with Lucide. The Lucide icon set (ISC licensed) is bundled inside the package, so everything works offline.

Why

AI assistants reach for emojis when a UI needs an icon, because drawing a good icon is actual design work. This server plugs into any MCP-compatible assistant (Claude Desktop, Claude Code, Cursor, and more) and lets it search 2000+ Lucide icons by keyword, restyle them (stroke width, color, size), and generate a whole matching set in one call so every icon on the page looks like it belongs together. The SVGs come back as markup the assistant saves straight into the project. No API key, no account, no network.

Tools

Quickstart

Install

No cloning needed:

uvx icon-mcp

or with pip:

pip install icon-mcp

From source instead:

git clone https://github.com/pratham-jain33/icon-mcp
cd icon-mcp
python -m venv .venv
.venv/bin/pip install -e .

Connect your assistant

Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
• Windows: %APPDATA%\Claude\claudedesktopconfig.json

{
  "mcpServers": {
    "icon-mcp": {
      "command": "uvx",
      "args": ["icon-mcp"]
    }
  }
}

No environment variables, no keys. From source, point at your checkout instead:

{
  "mcpServers": {
    "icon-mcp": {
      "command": "/absolute/path/to/icon-mcp/.venv/bin/python",
      "args": ["-m", "icon_mcp.server"]
    }
  }
}

Restart Claude Desktop, then try: "Find me a settings icon and a trash icon, both 1.5px stroke in #2f6bff at 32px, as SVGs."

Configuration

None. There is nothing to configure: no API keys, no accounts, no network access. The icon set ships inside the package.

How it works

1. You ask the assistant for icons in plain words.
2. The assistant calls searchicons to find the right names, or passes keywords straight to generateicons.
3. The server resolves each query to a bundled Lucide SVG and rewrites four attributes on it: width, height, stroke-width, stroke. Pure XML manipulation, no rendering, no native dependencies.
4. Every icon in one call gets the identical style, so the set is visually consistent by construction.
5. The server returns JSON with the SVG markup per icon; the assistant saves them as .svg files in your project.

Example session

You:    I need icons for my landing page nav: home, features, pricing,
        contact. Make them all match: thin 1.5 stroke, blue #2f6bff.

Claude: [calls generate_icons with ["home", "features", "pricing",
        "contact"], stroke_width=1.5, color="#2f6bff"]
        Done. Four SVGs, all 1.5px stroke in #2f6bff, saved to icons/.
        "features" resolved to the "sparkles" icon, "contact" to "mail".

Why icon-mcp instead of Unicon

Shortened. The full README is on GitHub.