Noun Project MCP Server

A Model Context Protocol (MCP) server for The Noun Project API, enabling Claude Code to search and retrieve icons programmatically.

Features

• Icon Search: Search for icons with advanced filters (style, line weight, public domain)
• Icon Details: Get detailed information about specific icons
• Collections: Retrieve icon collections
• Autocomplete: Get search term suggestions
• Usage Tracking: Monitor API quota and usage
• Download URLs: Get customized download links with color and size options

Prerequisites

1. Node.js: Version 18 or higher
2. Noun Project API Credentials: Get your API key and secret from The Noun Project

Installation

Quick Install (Recommended)

Install directly from npm and add to Claude Code in one command:

claude mcp add --transport stdio noun-project \
  --env NOUN_PROJECT_API_KEY=your_api_key_here \
  --env NOUN_PROJECT_API_SECRET=your_api_secret_here \
  -- npx -y noun-project-mcp

Replace your_api_key_here and your_api_secret_here with your actual credentials from The Noun Project.

Local Development

1. Clone and navigate to the repository:

git clone https://github.com/sgup/noun-project-mcp.git
cd noun-project-mcp

2. Install dependencies:

npm install

3. Build the TypeScript code:

npm run build

4. Add to Claude Code using local path:

claude mcp add --transport stdio noun-project \
  --env NOUN_PROJECT_API_KEY=your_api_key_here \
  --env NOUN_PROJECT_API_SECRET=your_api_secret_here \
  -- node /absolute/path/to/noun-project-mcp/dist/index.js

Available Tools

1. search_icons

Search for icons with various filters.

Parameters:

• query (required): Search term (e.g., “dog”, “house”)
• styles (optional): Filter by style - “solid”, “line”, or “solid,line”
• line_weight (optional): For line icons, specify weight (1-60) or range (e.g., “18-20”)
• limit_to_public_domain (optional): Set to 1 for public domain only
• thumbnail_size (optional): 42, 84, or 200 pixels
• include_svg (optional): Set to 1 to include SVG URLs
• limit (optional): Maximum number of results

Example:

{
  "query": "dog",
  "styles": "line",
  "limit": 10
}

2. get_icon

Get detailed information about a specific icon.

Parameters:

• icon_id (required): The icon’s unique ID
• thumbnail_size (optional): 42, 84, or 200 pixels

Example:

{
  "icon_id": 12345,
  "thumbnail_size": 200
}

3. get_collection

Retrieve a collection and its icons.

Parameters:

• collection_id (required): The collection’s unique ID
• thumbnail_size (optional): 42, 84, or 200 pixels
• include_svg (optional): Set to 1 to include SVG URLs
• limit (optional): Maximum number of icons to return

Example:

{
  "collection_id": 123
}