Skip to main content
Glama
Sign In
Noun MCP Server

Noun MCP Server

by alisaitteke
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Noun MCP

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

npm version GitHub release License: MIT TypeScript Node.js MCP Registry MCP Toplist

Noun MCP Server MCP server – quality and maintenance score on Glama

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.

Related MCP server: Supericons

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.

Install in Cursor Install in VS Code

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

  1. You type what you want in plain language.

  2. The AI searches first — search_icons is a cheap service call and already returns IDs, license, and thumbnails.

  3. 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

Contributing

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

Maintainer

Built by Ali Sait Teke — GitHub · LinkedIn.

License

MIT

Available Tools

7 tools
check_usageA

Show current API usage vs limits for hourly, daily, and monthly windows, split into service calls vs icon calls. Cached for 5 minutes.

Inputs: no named parameters.

download_iconA

Download one icon as SVG or PNG (optional color/size; FREE trial is public-domain only). This is an expensive icon call (150/day on the free trial). Use only when the user asked to save or embed the file, not to inspect search results.

Inputs: icon_id (required), size, color, filetype, +1 more.

get_collectionA

Get a collection and a page of its icons. Service call. Prefer this over calling get_icon on each member.

Inputs: collection_id (required), limit, next_page, prev_page, +2 more.

get_iconA

Get extra details for one icon, including a temporary SVG icon_url (expires in 1 hour). This is an expensive icon call (FREE trial: 150/day and 150/month). Skip it when search_icons already has the metadata you need.

Inputs: icon_id (required), thumbnail_size.

icon_autocompleteA

Autocomplete icon search terms (max 10). Cheap service call — use before searching if the query is ambiguous.

Inputs: query (required), limit.

search_collectionsA

Search Noun Project collections (icon sets). Service call — cheaper than get_icon/download_icon.

Inputs: query (required), limit, next_page, prev_page.

search_iconsA

Search The Noun Project for icons. Returns IDs, style, license, thumbnails, tags, and attribution. This is a cheap service call — do NOT follow up with get_icon for every result. Use download_icon only when the user wants a file. Prefer a specific query over pagination (FREE trial: 2,000 service calls/month, 1,000/day).

Inputs: query (required), limit, styles, next_page, +5 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    A4.1/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct operation: search/get/download for icons, search/get for collections, plus autocomplete and usage checking. get_icon and download_icon are the closest pair, but their descriptions clearly separate metadata/temporary URL retrieval from file download.

    Naming Consistency4/5

    Most tools follow a clear verb_noun pattern (get_icon, download_icon, search_icons, search_collections, check_usage). The exception is icon_autocomplete, which reverses the expected order and breaks the otherwise consistent naming convention.

    Tool Count5/5

    Seven tools is a well-scoped size for a niche icon search and download server. Each tool serves a clear purpose with no redundant entries.

    Completeness5/5

    The set covers the full read-only icon workflow: autocomplete, search icons, get icon details, download icons, search/get collections, and check API usage. There are no obvious missing operations for the stated domain.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers