MCP server for The Noun Project - search and download icons directly in Cursor AI and Claude
0 installs
Trust: 37 β Low
Devtools
Ask AI about io.github.alisaitteke/noun-mcp
Powered by Claude Β· Grounded in docs
I know everything about io.github.alisaitteke/noun-mcp. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
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.
# Run directly without installation
npx @alisaitteke/noun-mcp
Option B: Global Install
npm install -g @alisaitteke/noun-mcp
Option C: Local Development
git clone https://github.com/alisaitteke/noun-mcp.git
cd noun-mcp
npm install
npm run build
npm link
Step 3: Configure Environment
Create a .env file in the project directory:
cp .env.example .env
Edit .env with your credentials:
# Your API credentials from The Noun Project
NOUN_CONSUMER_KEY=your_consumer_key_here
NOUN_CONSUMER_SECRET=your_consumer_secret_here
# Choose your tier: FREE (5K calls/month) or PAID (unlimited)
NOUN_API_TIER=FREE
FREE vs PAID Tier
FREE Tier (5,000 API calls/month)
Perfect for personal projects and testing
Automatic cost optimizations
Smaller page sizes (max 10 results per search)
Optimized thumbnails (42px by default)
SVG URLs excluded by default (save bandwidth)
Smart usage alerts at 50%, 80%, 95%
PAID Tier (Unlimited)
No monthly limits
Larger page sizes (up to 100 results)
High-quality thumbnails (84px by default)
SVG URLs included automatically
No restrictions
Switch anytime: Just update NOUN_API_TIER in your .env file!
Step 4: Configure Cursor AI
Open Cursor settings: Settings β Features β MCP
"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"
"Download this icon as SVG with hex color FF5733"
Browse Collections
"Search for weather icon collections"
"Show me collection 123 details"
Get Suggestions
"Give me autocomplete suggestions for 'spo'"
Check Usage
"How many API calls have I used this month?"
"Check my API usage limits"
Available Tools
The AI can use these tools to help you:
search_icons
Search The Noun Project icon database.
What you can filter:
Style: solid, line, or both
Line weight: 1-60 or range like "18-20"
Public domain: Show only free-to-use icons
Thumbnail size: 42, 84, or 200 pixels
Include SVG: Get SVG URLs in results
Limit: Max results per page
Example:
"Search for 'coffee' icons in solid style, public domain only"
get_icon
Get detailed information about a specific icon.
Returns:
Icon name and ID
Creator information
Tags and collections
License details
Download URLs
Example:
"Show me details for icon 12345"
download_icon
Download an icon with custom options.
Options:
Format: SVG or PNG
Color: Any hex color (e.g., "FF0000" for red)
Size: 20-1200 pixels (PNG only)
Save to file: Optional file path
Note: FREE tier can only download public domain icons.
Example:
"Download icon 12345 as PNG, 200x200, red color, save to ./icons/coffee.png"
search_collections
Find icon collections by keyword.
Example:
"Search for 'travel' collections"
get_collection
View a specific collection with all its icons.
Example:
"Show me collection 456"
icon_autocomplete
Get search term suggestions (max 10).
Example:
"What terms start with 'comp'?"
check_usage
Check your API usage and limits.
Shows:
Monthly limit and usage
Remaining calls
Percentage used
Days until reset
Optimization tips (FREE tier)
FREE Tier Best Practices
Maximize your 5,000 monthly calls:
1. Be Specific
Bad: "icon" β Too broad, many pages needed
Good: "coffee cup" β Specific, better results
2. Use Autocomplete First
Step 1: "Suggestions for 'cof'" β ["coffee", "coffee cup"]
Step 2: "Search for 'coffee cup'" β Exact results
3. Avoid Pagination
Bad: Browsing 5 pages = 5 API calls
Good: Refine search to get results on first page
4. Download Once, Reuse
Download icon β Save to project β Use everywhere
(Don't re-download the same icon)
5. Filter for Public Domain
FREE tier can only download public domain icons
Filter searches with limit_to_public_domain=1
6. Cache Results
The server automatically caches usage data for 5 minutes.
You should also save:
Downloaded icons
Icon IDs you've explored
Collection information
Cost Optimization
The server automatically optimizes API usage in FREE tier mode: