Aria Icons logo

Aria Icons

Searches and retrieves SVG icons through local stdio or remote HTTP MCP, with CLI support for writing icons into projects.

Install Aria Icons

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "aria-icons": {
      "command": "npx",
      "args": [
        "-y",
        "aria-icons@latest"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 12 tools correctly ().

Overview

The Aria Icons MCP server connects AI clients to a searchable catalog of SVG icon collections. It supports local stdio through the npm CLI or remote HTTP at the hosted MCP endpoint, and can search, retrieve, compare, and map icons across sets. Reach for it when an agent needs project-ready icon source rather than a large icon dependency. Cursor, Claude, and VS Code setup is supported by the CLI.

Use cases

  • Search icon collections from an AI coding client
  • Retrieve SVG source for a selected icon
  • Write requested icons into a project
  • Map icons between different collections
  • Audit and migrate mixed icon-library imports

Key features

  • Searchable SVG icon catalog
  • Local stdio MCP transport
  • Remote HTTP MCP endpoint
  • Single and batch icon retrieval
  • Cross-collection similarity and mapping
  • CLI commands for repository icon management

Tools12

What Aria Icons lets your agent do. Expand a tool for its parameters.

Verified live~1.0k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

17/17 checks healthy over the last 62d

What it can do

From the 12 tools this server returned when we ran it.

Makes network requests · 1Read-only tools · 12
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age80 days
Maintainers1

Observed 2026-11-16 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev · aria-icons@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars106Stargazers on the source repository.
npm downloads171Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed12Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Aria Icons works

What Aria Icons does

The Aria Icons MCP server exposes a searchable catalog of SVG icon collections to MCP-compatible clients. It provides access to icons by identifiers such as lucide:house, tabler:arrow-up, and thesvg:github. An agent can search the catalog, retrieve one or more icons, inspect available collections, find similar icons, and map an icon to an equivalent in another collection.

The catalog combines vendored sets, theSVG brand logos, and Iconify collections. Search metadata includes names, tags, aliases, and categories. The same underlying catalog is available through the website, public REST API, CLI, and MCP endpoint.

As a Developer Tools listing, the Aria Icons MCP server fits workflows where an agent needs to select icons and return SVG or framework source. The companion CLI can also write requested icon files into a repository, audit mixed icon libraries, recommend a consistent collection, and migrate imports toward another set.

How it works

The local mode runs the published aria-icons package as a stdio MCP process. The package makes requests to the Aria Icons API rather than bundling the full icon database, so the CLI downloads only the icons requested. The default MCP command is available by running the package without additional arguments.

A remote configuration points an MCP client at https://icons.leularia.com/api/mcp. Both local and remote modes use the same catalog. The related REST API provides endpoints for search, single-icon retrieval, batch retrieval, collection listing, similar-icon lookup, and cross-set equivalent mapping.

Setup and configuration

Install or configure the CLI with one of these supported approaches:

  • npx -y aria-icons@latest setup
  • bunx aria-icons@latest setup
  • curl -fsSL https://icons.leularia.com/install.sh | bash

The setup command writes an MCP configuration using npx -y aria-icons as the local command. The README identifies Cursor, Claude, and VS Code as setup targets. For a remote configuration, use the hosted MCP URL instead of a command and argument list.

For local development against a self-hosted website, set ARIA_ICONS_API to the development API URL, such as http://localhost:3001. This variable is shown for development and is not required for the hosted service.

Tools and capabilities

The Aria Icons MCP server supports catalog operations corresponding to these capabilities:

  • Search icons across collections.
  • Retrieve an individual icon or a batch of icons.
  • Browse available collections.
  • Find similar icons or alternatives in other sets.
  • Map an icon to an equivalent in a selected collection.
  • Return SVG or framework source through the CLI workflow.

The CLI adds repository-oriented commands such as add, migrate, doctor, suggest, and init. These commands are separate from the MCP transport but use the same API-backed icon catalog.

Limitations and notes

The npm package does not contain the complete icon database; it depends on the Aria Icons API for catalog and icon data. Icon contributions must include appropriate sharing rights and license information, so the license terms may vary between collections.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Aria Icons

Aria Icons is an MCP server that connects AI clients to Aria Icons’ searchable SVG catalog through local stdio or remote HTTP. Its main tools support icon search, retrieving SVG or framework source, batch retrieval, collection browsing, similar-icon lookup, and cross-set equivalent mapping.

Install it with `npx -y aria-icons@latest setup`, `bunx aria-icons@latest setup`, or the hosted install script. The setup command writes a local stdio configuration that runs `npx -y aria-icons`; you can also configure the remote MCP URL directly.

Yes, Aria Icons supports Cursor configuration through the CLI setup command.

Yes, the CLI can write requested icon files into a repository with its `add` command. The CLI also includes commands for migrating icon-package imports, auditing mixed libraries, recommending a consistent set, and creating `.aria-icons.json`.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewAria Icons AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/aria-icons?style=directory)](https://allmcps.com/mcp/aria-icons)
HTML Embed
<a href="https://allmcps.com/mcp/aria-icons"><img src="https://allmcps.com/api/badge/aria-icons?style=directory" alt="Aria Icons on AllMCPs" /></a>