Logo
Noun MCP Server

Noun MCP Server

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.

An MCP (Model Context Protocol) server that enables AI assistants to search and download professional icons from The Noun Project directly within Cursor AI, Claude Desktop, and other MCP-supported tools.

An MCP (Model Context Protocol) server that enables AI assistants to search and download professional icons from The Noun Project directly within Cursor AI, Claude Desktop, and other MCP-supported tools.

What is it?

Instead of manually browsing The Noun Project website, you can now simply ask your AI assistant to find and download icons for your projects. The server acts as a bridge between your AI tools and The Noun Project's extensive icon library.

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!

Key Features

  • Icon Search: Find icons with filters for style, line weight, and licensing
  • Icon Download: Get SVG or PNG files with custom colors and sizes
  • Collection Browser: Explore curated icon collections
  • Smart Suggestions: Autocomplete helps find the right search terms
  • Usage Tracking: Monitor your API usage and limits
  • FREE Tier Support: Optimized for 5K monthly API calls
  • PAID Tier Support: Unlimited access with no restrictions

Quick Start

1. Get API Keys

Sign up at The Noun Project Developers and get your Consumer Key and Consumer Secret.

2. Configure 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"
      }
    }
  }
}

3. Start Using

Just ask your AI:

"Find me some coffee cup icons"
"Download icon 12345 in red color"
"Search for solid style house icons"

Usage Examples

Search for Icons

"Find me some coffee cup icons"
"Search for solid style house icons"
"Show me line icons with weight 18-20 for 'bicycle'"

Download Icons

"Download icon 12345 in red color"
"Get icon 67890 as PNG, 200x200 pixels, save to ./icons/house.png"

Browse Collections

"Search for weather icon collections"
"Show me collection 123 details"

API Tiers

FREE Tier (5,000 calls/month)

  • Perfect for personal projects
  • Automatic cost optimizations
  • Public domain icons only for downloads
  • Smart usage alerts

PAID Tier (Unlimited)

  • No monthly limits
  • All icons available
  • Larger page sizes
  • High-quality thumbnails

Technologies

  • TypeScript
  • MCP (Model Context Protocol)
  • The Noun Project API
  • OAuth 1.0a authentication

Installation

# Using npx (recommended)
npx @alisaitteke/noun-mcp

# Or install globally
npm install -g @alisaitteke/noun-mcp

This project makes it effortless to integrate professional icons into your workflow through AI assistants, eliminating the need to manually browse and download icons.