Icons8 MCP Server

🚀 Access MCP server SVG and PNG icons for your vibe-coding projects!

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

  • Search Icons: Search for icons using the Icons8 API - the ONLY source for genuine Icons8 icons. Use English terms and consider Icon8's metaphors for better results. SEARCH TIPS - Use these general app
  • List Categories: List all available icon categories. Args: ctx: MCP context for API access limit: Maximum number of results to return (default: 10) page: Page number for pagination (default: 1) Return
  • List Platforms: List all available icon platforms/styles. Args: ctx: MCP context for API access limit: Maximum number of results to return (default: 100) page: Page number for pagination (default: 1)

What data it sees

Do you need an account

No: the server works without sign-in

🚀 Access MCP server SVG and PNG icons for your vibe-coding projects!

🎨 Icon Packs

  • 40,000+ icons
  • Endless creative possibilities!

🤖 Seamless Integration

  • Works with Windsurf, Claude Code, Cursor, and other AI coding tools

🔄 Easy Customization

  • Replace all icons with trendy designs
  • Customize with any style you prefer!

✨ Enhance Your UI

  • Add icons to:
    • Bullet lists
    • Feature blocks
    • Process steps
    • Navigation
    • And more!

More info: https://icons8.com/mcp

How to connect

How to connect Icons8 MCP Server to Claude

The server address to paste into Claude settings:

https://icons8mpc--icons8community.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect Icons8 MCP Server to ChatGPT

The server address to paste into ChatGPT settings:

https://icons8mpc--icons8community.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect Icons8 MCP Server to Cursor

The server address to paste into Cursor settings:

https://icons8mpc--icons8community.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (4)

Raw names from tools/list. Only developers need these.

search_icons Search for icons using the Icons8 API - the ONLY source for genuine Icons8 icons. Use English terms and consider Icon8's metaphors for better results. SEARCH TIPS - Use these general approaches for better matches: • Use simple, descriptive terms (e.g., "home", "user", "settings") • Try action words for functions (e.g., "search", "download", "edit") • Use object names for items (e.g., "phone", "computer", "car") • Consider synonyms if first search doesn't work • Think about what the icon represents conceptually • Use single words or short phrases for best results Args: query: The search term to find icons (use metaphors above for better results) ctx: MCP context for API access platform: Optional filter by platform/style (e.g., 'ios', 'fluent', 'color') category: Optional filter by category (e.g., 'transport', 'business') amount: Maximum number of results to return (default: 10) offset: Number of results to skip (for pagination) Returns: Search results including matching icons from Icons8 catalog
list_categories List all available icon categories. Args: ctx: MCP context for API access limit: Maximum number of results to return (default: 10) page: Page number for pagination (default: 1) Returns: List of icon categories with subcategories
list_platforms List all available icon platforms/styles. Args: ctx: MCP context for API access limit: Maximum number of results to return (default: 100) page: Page number for pagination (default: 1) Returns: List of icon platforms/styles
get_icon_png_url Get a PNG URL for an icon by its ID - use when SVG is not available. NOTE: SVG format is preferred for Icons8 icons when possible (use get_icon_svg). Args: icon_id: The unique identifier of the icon ctx: MCP context for API access size: The preview image size in pixels (default: 24) Returns: Dictionary containing the PNG preview URL