English Français العربية

io.github.alisaitteke/noun-mcp

Official registry Search and web

Production MCP server for The Noun Project — search & download icons in Cursor/Claude with OAuth…

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @alisaitteke/noun-mcp
Claude Code 
claude mcp add noun-mcp -e 'NOUN_CONSUMER_KEY=<your noun_consumer_key>' -e 'NOUN_CONSUMER_SECRET=<your noun_consumer_secret>' -e 'NOUN_API_TIER=<NOUN_API_TIER>' -- npx -y @alisaitteke/noun-mcp@1.0.6
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "noun-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@alisaitteke/noun-mcp@1.0.6"
            ],
            "env": {
                "NOUN_CONSUMER_KEY": "<your noun_consumer_key>",
                "NOUN_CONSUMER_SECRET": "<your noun_consumer_secret>",
                "NOUN_API_TIER": "<NOUN_API_TIER>"
            }
        }
    }
}

Environment variables

  • NOUN_CONSUMER_KEY required secret Consumer Key from The Noun Project API
  • NOUN_CONSUMER_SECRET required secret Consumer Secret from The Noun Project API
  • NOUN_API_TIER required API tier: FREE (trial quotas) or PAID (Pay-Per-Use)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Noun MCP
  2. What can it do?
  3. Try saying
  4. Get started
  5. How it works
  6. Documentation
  7. Contributing
  8. Maintainer
  9. License

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

  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

Frequently asked questions

What is io.github.alisaitteke/noun-mcp?

Production MCP server for The Noun Project — search & download icons in Cursor/Claude with OAuth…

How do I install io.github.alisaitteke/noun-mcp?

It runs on your machine. In Claude Code: claude mcp add noun-mcp -e 'NOUN_CONSUMER_KEY=<your noun_consumer_key>' -e 'NOUN_CONSUMER_SECRET=<your noun_consumer_secret>' -e 'NOUN_API_TIER=<NOUN_API_TIER>' -- npx -y @alisaitteke/noun-mcp@1.0.6. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.alisaitteke/noun-mcp need an API key?

Yes. It expects NOUN_CONSUMER_KEY, NOUN_CONSUMER_SECRET, NOUN_API_TIER, which you set in its configuration.

Is io.github.alisaitteke/noun-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.alisaitteke/noun-mcp?

It is published by alisaitteke. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.