Noun Project

Noun Project MCP

typescript

2

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "sgup-noun-project-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "noun-project-mcp"
      ],
      "env": {
        "NOUN_PROJECT_API_KEY": "your_api_key_here",
        "NOUN_PROJECT_API_SECRET": "your_api_secret_here"
      }
    }
  }
}

You run a MCP server that connects to The Noun Project API to search icons, fetch details, retrieve collections, autocomplete terms, track usage, and generate customized download URLs. This server lets you integrate icon data into your applications and workflows with secure credentials and flexible transport options.

How to use

You interact with the MCP server through your MCP client by selecting a transport (stdio) and the noun-project server configuration. Use the search and retrieval endpoints to find icons by term, filter by style and weight, fetch icon details, obtain collections, and get download links. Track usage to stay within your quota and request autocomplete suggestions to improve user search experiences.

How to install

Prerequisites: you need Node.js version 18 or higher. You also need credentials from The Noun Project (API Key and API Secret). Placeholders are shown where you will provide your real values.

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

If you prefer developing locally, run these steps to clone the project, install dependencies, build, and then run from a local path.

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

npm install

npm run build

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

Configuration and running notes

The server authenticates with The Noun Project API using OAuth 1.0. Your credentials are included in the runtime environment so you do not need to sign requests yourself. If you change credentials, update the mcp configuration by re-adding the server with the new API key and secret.

To verify your MCP setup and see the active servers, you can list them from your MCP client.

Security and usage considerations

Keep your API key and secret secure. Do not share them in logs or publicly accessible files. Monitor your usage with the check_usage tool to avoid hitting monthly quotas.

Troubleshooting

If you encounter errors about missing API credentials, ensure you used the correct --env flags when adding the MCP server and that the variables are in your shell environment when the MCP client launches.

Notes

This MCP server provides tools to search icons, fetch icon details, retrieve collections, autocomplete search terms, check usage, and obtain customized download URLs. Each tool corresponds to a functional endpoint you can invoke from your MCP client.

Available tools

search_icons

Search for icons with advanced filters such as style, line weight, and public domain status.

get_icon

Fetch detailed information about a specific icon by its ID.

get_collection

Retrieve a collection and its icons, with options for thumbnail size and SVG inclusion.

icon_autocomplete

Get autocomplete suggestions for partial search terms.

check_usage

Check current API usage and limits to monitor quotas.

get_download_url

Obtain a downloadable icon URL with optional color, filetype, and size parameters.