Provides search, download, and usage features for The Noun Project icons via MCP-enabled AI tools.
Configuration
View docs{
"mcpServers": {
"alisaitteke-noun-mcp": {
"command": "npx",
"args": [
"-y",
"@alisaitteke/noun-mcp"
],
"env": {
"NOUN_API_TIER": "FREE",
"NOUN_CONSUMER_KEY": "your_key_here",
"NOUN_CONSUMER_SECRET": "your_secret_here"
}
}
}
}You run a Model Context Protocol (MCP) server that lets AI assistants search, download, and use The Noun Project icons directly in your AI workflows. This makes it easy to find exact icons, fetch SVG or PNG assets, and manage usage across tools like Cursor AI and Claude Desktop without leaving your conversation.
You integrate the MCP server with your client so your AI can search for icons, retrieve details, and download assets on demand. Use natural language prompts to search by keyword, style, and license, then request downloads or browse collections. The MCP server handles authentication with The Noun Project, applies tier-based limits, and returns icons in your preferred format and size.
Prerequisites: install Node.js 18 or higher and have access to The Noun Project API keys.
# Step 1: Get API keys from The Noun Project developers page
# Step 2: Install the MCP package (example with npx)
# Run directly without installation
npx @alisaitteke/noun-mcpConfigure your MCP client to connect to the noun-project MCP server using a stdio (local) configuration. The following settings run the MCP server via npx and provide your API credentials and tier.
{
"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"
}
}
}
}If you are setting up Claude Desktop or Claude Code, the same configuration applies in your MCP settings. The key pieces are the command, the package to run, and the environment variables for authentication and tier selection.
Step by step, you can also configure an environment file to keep credentials out of your main config. Create a file named .env and populate it with your keys and tier.
# Step 3: Configure Environment
cp .env.example .env
```
```
# Edit .env to include your credentials
NOUN_CONSUMER_KEY=your_consumer_key_here
NOUN_CONSUMER_SECRET=your_consumer_secret_here
NOUN_API_TIER=FREEFollow this flow to get the MCP server running with your client.
# Step 1: Get API keys from The Noun Project developers portal
# Step 2: Install or run the MCP server
npx @alisaitteke/noun-mcp
# Step 3: Provide keys and tier via environment variables
# Step 4: Point your MCP-enabled client to the running serverKeep API keys secret. Use environment variables or a secrets manager to avoid embedding keys in source files. Switch from FREE to PAID only when you need higher limits or broader icon access.
If the server isn’t detected by your client, restart the client, verify JSON configuration syntax, ensure absolute file paths if you reference local scripts, and check server logs for errors.
The MCP server exposes a set of tools to search, inspect, and download icons as well as explore collections and monitor usage.
Search The Noun Project icon database with filters for style, line weight, licensing, thumbnail size, and result limits.
Retrieve detailed information about a specific icon, including name, creator, tags, license, and download URLs.
Download an icon with options for format, color, size, and optional save path.
Find icon collections by keyword to explore curated groups.
Inspect a specific collection and its icons.
Get search term suggestions to speed up queries.
Check your API usage, limits, and remaining calls.