--- title: "Heroicons MCP - Free to Use In Your AI Editor" product: "Streamline Icons, Illustrations and Elements" url: /heroicons-mcp canonical_url: "https://design.streamlinehq.com/heroicons-mcp" summary: "The Heroicons MCP is free to use in Claude Code, Cursor, or ChatGPT. Search all 324 Heroicons icons, then download SVG or PNG without leaving your editor." --- # Connect to the Heroicons MCP for free > The Heroicons MCP is free to use in Claude Code, Cursor, or ChatGPT. Search all 324 Heroicons icons, then download SVG or PNG without leaving your editor. - **URL**: https://design.streamlinehq.com/heroicons-mcp --- * The MCP is free to use, no paid plan needed * 324 open source icons by Tailwind Labs, also free * Searchable alongside Streamline's full library [Connect the MCP Server](https://www.streamlinehq.com/mcp), [Browse Heroicons Icons](https://www.streamlinehq.com/icons/heroicons-outline) ## Connect the Heroicons MCP in three steps Pick your tool, paste the block, and sign in once. Heroicons is then searchable from wherever you are already working. ### Claude Install the official Streamline connector from the Claude directory. #### Step 1: Add the connector Open Streamline in the Claude directory and click Connect. [Add to Claude](https://claude.ai/directory/connectors/streamline-icons) **Using Claude Code?** Run this in your terminal, then run /mcp in Claude Code and pick streamline. ``` claude mcp add --transport http streamline https://public-api.streamlinehq.com/mcp ``` #### Step 2: Sign in Sign in with your Streamline account to authorize access. ### Cursor Install Streamline in Cursor with one click. #### Step 1: Add the server Click install to open Cursor and add the Streamline MCP. [Install in Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=streamline&config=eyJ1cmwiOiJodHRwczovL3B1YmxpYy1hcGkuc3RyZWFtbGluZWhxLmNvbS9tY3AifQ%3D%3D) **Prefer to add it manually?** Add this to your \~/.cursor/mcp.json file. ``` { "mcpServers": { "streamline": { "url": "https://public-api.streamlinehq.com/mcp" } } } ``` #### Step 2: Sign in Sign in with your Streamline account to authorize access. ### ChatGPT In ChatGPT, go to Settings, then Plugins, then MCPs, and click Add Server. Fill the form with these three values. #### Step 1: Fill the form Name, type, and URL, exactly as below. ``` Name Streamline Type Streamable HTTP URL https://public-api.streamlinehq.com/mcp ``` #### Step 2: Save and authenticate Click Save, then click Authenticate and follow the steps. ### Antigravity The Antigravity CLI and the Antigravity IDE read one config file, so you set this up once and both pick it up. #### Step 1: Add the config Put this in \~/.gemini/config/mcp\_config.json. A headers block is unnecessary, because Streamline supports dynamic client registration and Antigravity discovers the OAuth endpoints on its own. ``` { "mcpServers": { "streamline": { "serverUrl": "https://public-api.streamlinehq.com/mcp" } } } ``` #### Step 2: Authenticate Open Agent Settings, go to the Customizations tab, and click Authenticate next to streamline. Sign in, then copy the authorization code back into the settings panel and click Submit. ### Others Most MCP-compatible clients accept a JSON configuration block. Streamline supports dynamic client registration, so there are no client credentials to configure. #### Step 1: Add the configuration The first time the client connects it opens your browser to sign in and authorize access. ``` { "mcpServers": { "streamlineMCPServer": { "name": "Streamline MCP Server", "url": "https://public-api.streamlinehq.com/mcp" } } } ``` #### Step 2: Use an API key if the client has no OAuth Add your Streamline API key as a header instead, replacing YOUR\_API\_KEY\_HERE. ``` { "mcpServers": { "streamlineMCPServer": { "name": "Streamline MCP Server", "url": "https://public-api.streamlinehq.com/mcp", "headers": { "X-API-Key": "YOUR_API_KEY_HERE" } } } } ``` To confirm any of them connected, ask your tool to search for a dog icon. The results should come back from Streamline. ## Heroicons has 324 free icons in each of Outline and Solid Created by Tailwind Labs, free and open source, hosted on Streamline and searchable through the MCP. * **Heroicons Outline**: [324 free icons](https://www.streamlinehq.com/icons/heroicons-outline) * **Heroicons Solid**: [324 free icons](https://www.streamlinehq.com/icons/heroicons-solid) ## Core is the set that pairs with it 998 free, 5,615 pro icons per style. Core Line and Core Solid carry the same shapes in both weights. * **Core Line**: [998 free icons](https://www.streamlinehq.com/icons/core-line-free), [5,615 pro icons](https://www.streamlinehq.com/icons/core-line) * **Core Solid**: [998 free icons](https://www.streamlinehq.com/icons/core-solid-free), [5,615 pro icons](https://www.streamlinehq.com/icons/core-solid) ## Demos built with MCP Small things an AI made end to end, with every asset searched and downloaded through the MCP instead of pasted in by hand. ### Pixel Drop A small arcade game: catch stars and coins with the rocket, avoid bugs and skulls. Tap the screen to play, then move with the arrow keys or drag. Built by Claude Fable 5.1 with the Streamline MCP. Every sprite comes from the Pixel icon set. [Open the game on its own page](https://design.streamlinehq.com/mcp-demos/pixel-drop) ### Emoji Chat A messenger with its own emoji keyboard. Tap the smiley to browse, or type a colon and a word, like :fire, to drop one in mid-sentence. Built by Claude Opus 5.5 with the Streamline MCP. Every emoji comes from the Streamline Emoji set. [Open the chat on its own page](https://design.streamlinehq.com/mcp-demos/emoji-chat) ### Style Switcher One app, 32 icon styles. Pick a family and a style and every icon in the UI swaps in place, because each one exists under the same name in every style. Built by Claude Opus 5.5 with the Streamline MCP. Icons from the free Core, Sharp, Flex, and Plump sets. [Open the switcher on its own page](https://design.streamlinehq.com/mcp-demos/style-switcher) ## Works in your tools * [Mac App](https://home.streamlinehq.com/plugins/download): Drag and drop icons directly into any app * [Figma](https://www.figma.com/community/plugin/852192486284901337): Browse and insert icons without leaving Figma * [Framer](https://www.framer.com/marketplace/plugins/core-icons-by-streamline/): Use icons natively in Framer projects * [Webflow](https://webflow.com/apps/detail/streamline-icons): Add icons directly to Webflow sites * [VS Code](https://marketplace.visualstudio.com/items?itemName=streamline.streamline-icons): Insert icons as SVG or JSX in editors * [Lucid](https://lucid.co/marketplace/01f05f6d/streamline-icons-illustrations-emojis-and-elements): Add icons to your Lucidchart diagrams * [Miro](https://miro.com/marketplace/streamline/): Drop icons into your Miro boards * [Adobe Express](https://adobesparkpost.app.link/TR9Mb7TXFLb?addOnId=w165n33k3): Use icons in Adobe Express projects ## Heroicons is free, Pro widens the rest Every Heroicons icon is free through the MCP. Pro opens the rest of the library on the same MCP. ### Free: $0 * 109,582 icons * Mandatory attribution * All plugins, web app, MCP and API (limited) * Adjust size, color and format [Get started](https://www.streamlinehq.com/free) ### Pro subscription: $19 per month * 333,032 pro icons on top * Full resolution PNG exports * 58 pro sets in 11 families * All plugins, web app, MCP and API * Pay monthly or yearly [Get Pro](https://www.streamlinehq.com/pricing) ### One-time purchase: Lifetime * Buy once, own forever * Future assets included * All source files as a ZIP * All plugins, web app, MCP and API * No renewal fees [Get Lifetime](https://www.streamlinehq.com/lifetime) ## Heroicons Through The Streamline MCP Heroicons is a free and open source icon set, made by Tailwind Labs. Streamline hosts it, and the MCP searches it from inside the tool you are already working in. Setup is one block and a browser sign-in. The server is hosted, which keeps the whole thing to a config entry rather than a dependency. ## Proudly Independent Streamline is profitable and independent. We build only for our customers. Over the last sixteen years we have watched many competitors launch icon sets, then disappear. Most of those sets were never expanded or maintained. We are here for the long term. ## Calm Pricing We believe that creativity requires a calm mind. Creativity cannot be rushed. Other libraries charge per asset, or track how many pageviews your project gets. That adds stress to an already demanding job. With us you can iterate without watching a countdown, and use the assets across unlimited projects. ## Frequently asked questions Quick answers about using Heroicons icons through an MCP. ### What is the Heroicons MCP? The Heroicons MCP is Streamline's MCP server, which serves Heroicons along with every other set it hosts. One MCP covers Heroicons and the rest of the library alongside it. ### How do I connect it? Pick your tool in the steps above and paste the block it gives you, then sign in through the browser. The same instructions live on [streamlinehq.com/mcp](https://www.streamlinehq.com/mcp). ### How many Heroicons icons are there? 324, free, in each of Outline and Solid. Heroicons is made and maintained by Tailwind Labs at [heroicons.com](https://heroicons.com). ### Is Heroicons free to use? Yes. Heroicons is open source and free on Streamline. Each open-source set follows its own license, so check Heroicons's before shipping commercially. ### What formats and sizes come back? SVG or PNG, sized anywhere from 1 to 4096 pixels. The same call sets colours, a background colour and a stroke width. ### Can I reach other sets on the same MCP? Yes. The same server hosts every Streamline family, so a wider prompt picks up Core, Flex, Sharp and Plump. ### Can I connect other icon sets the same way? Yes. The same server reaches every set Streamline hosts. See [the icons MCP page](/icons-mcp.md) for the full picture.