Noun MCP Server

Noun MCP Server

⚠️ Unofficial Project · This is an independent third-party tool using The Noun Project API. Not affiliated with or endorsed by The Noun Project.

MCP (Model Context Protocol) server for searching, downloading, and using icons from The Noun Project in Cursor AI, Claude Desktop, and other MCP-supported AI tools.

---

🚀 Quick Start

<table> <tr> <td width="33%">

Cursor AI

Add to MCP settings:

{
  "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"
      }
    }
  }
}

</td> <td width="33%">

Claude Desktop

Add to config:

{
  "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"
      }
    }
  }
}

</td> <td width="33%">

Claude Code

Run in terminal:

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

</td> </tr> </table>

Get your API keys →

What is this? A bridge that lets AI assistants search and download professional icons for your projects. No manual browsing needed - just ask your AI!

Features

• <source media="(prefers-color-scheme: dark)" srcset="docs/icons/search-white.svg"> Icon Search: Find icons with filters for style, line weight, and licensing
• <source media="(prefers-color-scheme: dark)" srcset="docs/icons/download-white.svg"> Icon Download: Get SVG or PNG files with custom colors and sizes
• <source media="(prefers-color-scheme: dark)" srcset="docs/icons/book-white.svg"> Collection Browser: Explore curated icon collections
• <source media="(prefers-color-scheme: dark)" srcset="docs/icons/lightbulb-white.svg"> Smart Suggestions: Autocomplete helps find the right search terms
• <source media="(prefers-color-scheme: dark)" srcset="docs/icons/chart-white.svg"> Usage Tracking: Monitor your API usage and limits
• <source media="(prefers-color-scheme: dark)" srcset="docs/icons/free-white.svg"> FREE Tier Mode: Smart optimizations for 5K monthly API calls
• <source media="(prefers-color-scheme: dark)" srcset="docs/icons/diamond-white.svg"> PAID Tier Mode: Unlimited access with no restrictions

Requirements

• Node.js 18 or higher (Download)
• The Noun Project API Keys (free account works!)

Don't have API keys? Get them here →

Quick Start

Step 1: Get Your API Keys

1. Go to The Noun Project Developers
2. Sign in or create a free account
3. Create a new app (or select an existing one)
4. Copy your Consumer Key and **Consume