Heroicons MCP Server

@SeeYangZhi

Basic information

About Heroicons MCP Server

heroicons-mcp is a Model Context Protocol (MCP) server that exposes Heroicons. It allows LLMs and agentic applications to search, list, and generate usage examples of icons in React applications.

#mcp#heroicons-react#mcp-server

Heroicons MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "heroicons": {
      "command": "npx",
      "args": [
        "heroicons-mcp",
        "--stdio"
      ]
    }
  }
}

Heroicons MCP Server tools

Search for icons from heroicons by name or category

Get usage examples for an icon

List all icons from the heroicons library, optionally filtered by style

Overview

What is heroicons-mcp?

heroicons-mcp is a Model Context Protocol (MCP) server that exposes Heroicons as resources and tools for LLMs and agentic applications. Built with Bun and the MCP TypeScript SDK, it provides access to Heroicons in Outline and Solid styles.

How to use heroicons-mcp?

Install dependencies with bun install, then run either npx heroicons-mcp for HTTP mode (defaults to port 3000) or npx heroicons-mcp --stdio for stdio mode. For integration with Claude Desktop, add the server to the mcpServers section of the Claude Desktop configuration file using the npx command or a direct path to the built entry point.

Key features of heroicons-mcp

Exposes Heroicons as MCP resources (Outline and Solid)
Provides list_all_icons tool with optional style filter
Provides search_icons tool by name or keywords
Provides get_icon_usage_examples tool returning JSX code
Works in HTTP mode or stdio mode for MCP clients

Use cases of heroicons-mcp

AI coding assistants searching for a specific Heroicon by name
Generating JSX usage examples for a chosen icon
Listing all available icons within a single style (outline or solid)
Integrating icon access into agentic workflows via MCP clients

Frequently asked questions

What runtime does heroicons-mcp require?

It requires Git and Bun for development, but can be run via `npx` (Node.js) in production.

How do I run heroicons-mcp in HTTP vs stdio mode?

Use `npx heroicons-mcp` for HTTP mode (default), or add `--stdio` for stdio mode.

How can I integrate heroicons-mcp with Claude Desktop?

Add it to your Claude Desktop config file under `mcpServers` using the `npx` command or a direct path to the built `entry.js` file with the `--stdio` flag.

What tools does heroicons-mcp expose?

It exposes three tools: `list_all_icons`, `search_icons`, and `get_icon_usage_examples`.

Which Heroicons styles are included?

The server includes icons in both Outline and Solid styles from Heroicons.

Comments

More Other MCP servers

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct