Overview
What is Noun Project?
A Model Context Protocol (MCP) server that integrates with The Noun Project API, enabling Claude Code to search, retrieve, and download icons programmatically. It is designed for developers using Claude Code who need to access icon libraries.
How to use Noun Project?
Install via npm and add to Claude Code using the claude mcp add command with your Noun Project API credentials set as environment variables. The server provides six tools accessible through Claude Code: search_icons, get_icon, get_collection, icon_autocomplete, check_usage, and get_download_url.
Key features of Noun Project
- Icon search with advanced filters (style, line weight, public domain)
- Detailed icon information retrieval by ID
- Icon collection browsing
- Search term autocomplete suggestions
- Usage tracking and API quota monitoring
- Customized download URLs with color and size options
Use cases of Noun Project
- Search for icons to use in design projects directly from Claude Code
- Retrieve detailed metadata for a specific icon by its ID
- Browse themed icon collections for batch usage
- Generate download links for icons with custom colors and file formats
- Monitor Noun Project API usage to stay within monthly limits
FAQ from Noun Project
What dependencies are required to run Noun Project?
Node.js version 18 or higher and valid Noun Project API credentials (API key and secret) from thenounproject.com/developers/.
How do I authenticate with The Noun Project API?
The server handles OAuth 1.0 authentication automatically using your NOUN_PROJECT_API_KEY and NOUN_PROJECT_API_SECRET environment variables.
Where are my API credentials stored?
Credentials are set as environment variables when adding the server via claude mcp add with the --env flags.
What are the usage limits of Noun Project?
The Noun Project API has monthly usage limits; use the check_usage tool to monitor your quota.
What transport does Noun Project use?
The server uses stdio transport, configured via claude mcp add --transport stdio.
