noun-mcp

Name: noun-mcp
Author: alisaitteke

Local

github.com/alisaittekeMedia & Design7Updated 6w ago

Repository

About noun-mcp

noun-mcp lets AI assistants search The Noun Project and download icons into a project. It supports style and license filters, collections, and configurable SVG or PNG output.

Key features

01Search by style and license
02Download SVG or PNG
03Set output color and size
04Browse curated collections
05Autocomplete search terms
06Track API and icon usage

Use cases

01Find a public-domain coffee cup icon
02Download a colored icon into a project
03Check monthly API usage

MCP support

The MCP server exposes seven tools for searching, browsing, downloading, and tracking usage in The Noun Project. It can be configured in MCP clients such as Cursor, Claude Desktop, and Claude Code.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "alisaitteke-noun": {
      "command": "npx",
      "args": [
        "-y",
        "@alisaitteke/noun-mcp"
      ],
      "env": {
        "NOUN_CONSUMER_KEY": "<NOUN_CONSUMER_KEY>",
        "NOUN_CONSUMER_SECRET": "<NOUN_CONSUMER_SECRET>",
        "NOUN_API_TIER": "<NOUN_API_TIER>"
      }
    }
  }
}

Run commandnpx -y @alisaitteke/noun-mcp

Environment variables to set

NOUN_CONSUMER_KEYSecretConsumer Key from The Noun Project API

NOUN_CONSUMER_SECRETSecretConsumer Secret from The Noun Project API

NOUN_API_TIERAPI tier: FREE (trial quotas) or PAID (Pay-Per-Use)

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npm@alisaitteke/noun-mcp1.0.6stdio

Tools

Saved tool list · updated 2w ago

Parameter	Type	Required	Description
limit	number	No	Maximum number of results
query	string	Yes	Search term (e.g., "dog", "house", "bicycle")
styles	enum	No	Icon style: solid, line, or bothsolid \| line \| solid,line
next_page	string	No	Token for next page
prev_page	string	No	Token for previous page
include_svg	enum	No	Include SVG URLs in response (1=yes, 0=no)0 \| 1
line_weight	number\|string	No	Line weight for line icons (1-60) or range (e.g., "18-20")
thumbnail_size	enum	No	Thumbnail size in pixels42 \| 84 \| 200
limit_to_public_domain	enum	No	Show only public domain icons (1=yes, 0=no)0 \| 1

Details

From the project README

Noun MCP

Languages: English · 简体中文 · Español · Deutsch · 日本語 · Türkçe

Ask for icons in plain words. Describe what you need — "a solid coffee cup, public domain" — and your AI assistant searches The Noun Project, picks a match, and downloads SVG or PNG into your project. Works with Cursor, Claude Desktop, and Claude Code.

Note: This is an unofficial, community-maintained project and is not affiliated with or endorsed by The Noun Project.

What can it do?

Search — filter by style, line weight, and public-domain license
Download — SVG or PNG, custom color and size, saved to a path you choose
Browse collections — curated icon sets, not just one-off searches
Autocomplete — get better search terms before you burn quota
Track usage — hourly, daily, and monthly service vs icon windows
Stay on the free trial — client-side caps so 150 icon calls/month last longer

Under the hood: 7 tools — full list in docs/available-tools.md.

Try saying

Find solid public-domain coffee cup icons, then download one as a red SVG into ./icons.

Suggest search terms for "spo", then search weather collections.

How many Noun Project API calls have I used this month?

Get started

You need Node.js 18+ and Noun Project API keys (create an app — a free account works). Set NOUN_API_TIER to FREE (2,000 service / 150 icon calls per month) or PAID. Quota details: docs/available-tools.md.

Replace your_key / your_secret with your Consumer Key and Secret after install.

Claude Code:

claude mcp add \
  --transport stdio \
  noun-project \
  --env NOUN_CONSUMER_KEY=your_key \
  --env NOUN_CONSUMER_SECRET=your_secret \
  --env NOUN_API_TIER=FREE \
  -- npx -y @alisaitteke/noun-mcp

Or add this to your MCP client's config (Cursor, Claude Desktop, …):

{
  "mcpServers": {
    "noun-project": {
      "command": "npx",
      "args": ["-y", "@alisaitteke/noun-mcp"],
      "env": {
        "NOUN_CONSUMER_KEY": "your_key",
        "NOUN_CONSUMER_SECRET": "your_secret",
        "NOUN_API_TIER": "FREE"
      }
    }
  }
}

Ready-made files: examples/cursor-config.json, examples/claude-desktop-config.json.

How it works

You type what you want in plain language.
The AI searches first — search_icons is a cheap service call and already returns IDs, license, and thumbnails.
Download only when you need a file — each download_icon / get_icon spends an icon call.

Hit a quota error? Ask for check_usage, then wait or refine. Common fixes: docs/troubleshooting.md.

Documentation

Available tools — all 7 tools, parameters, FREE vs PAID
Troubleshooting — keys, 429s, public-domain downloads
Architecture — OAuth, queue, retry, cache
Development — build from source, tests

Contributing

Contributions are welcome! Please read CONTRIBUTING.md before opening a PR.

Maintainer

Built by Ali Sait Teke — GitHub · LinkedIn.

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.