Skip to main content
Glama
figma-svg-to-icon-mcp

figma-svg-to-icon-mcp

by Pruthvik1

figma-svg-to-icon-mcp

An MCP (Model Context Protocol) server that extracts SVG icons from Figma and generates React TSX icon components — automatically, from your AI assistant.

Works with GitHub Copilot, Claude, and any MCP-compatible AI assistant.

Setup

Prerequisites

  • Node.js 18+

  • VS Code with GitHub Copilot (agent mode) or Claude Desktop

  • A Figma personal access token

1. Get a Figma Token

Go to figma.com → Settings → Security → Personal access tokens → Generate new token.

Scopes needed: file_content:read

2. Configure your MCP client

VS Code (.vscode/mcp.json or user settings):

{
 "servers": {
  "figma-svg-to-icon-mcp": {
   "type": "stdio",
   "command": "npx",
   "args": ["-y", "figma-svg-to-icon-mcp"],
   "env": {
    "FIGMA_TOKEN": "figd_your_token_here"
   }
  }
 }
}

Claude Desktop (claude_desktop_config.json):

{
 "mcpServers": {
  "figma-svg-to-icon-mcp": {
   "command": "npx",
   "args": ["-y", "figma-svg-to-icon-mcp"],
   "env": {
    "FIGMA_TOKEN": "figd_your_token_here"
   }
  }
 }
}

Note: Each user needs their own FIGMA_TOKEN. Tokens are tied to Figma account permissions.

Related MCP server: Figma to React MCP

What it does

Point it at any Figma node URL and it will:

  1. Fetch the full node tree via Figma REST API (handles deeply nested instances)

  2. Detect icon nodes by name pattern + size

  3. Export clean SVG via Figma's image export API

  4. Check your existing components/icons folder for duplicates (name + path similarity)

  5. Generate .tsx icon components in a consistent format

Generated component format:

interface IconProps {
 className?: string;
}

export default function ArrowRightIcon({ className }: IconProps) {
 return (
  <svg xmlns="http://www.w3.org/2000/svg" width="1em" height="1em" viewBox="0 0 20 20" fill="none" className={className}>
   <path d="..." stroke="currentColor" strokeWidth="1.66667" strokeLinecap="round" strokeLinejoin="round" />
  </svg>
 );
}

Usage

Once configured, just tell your AI assistant:

Extract all icons from this Figma node and save new ones to my icons folder.

figma_url: https://www.figma.com/design/FILEID/Name?node-id=1234-5678
icons_dir: /absolute/path/to/your/project/src/components/icons

Options

Parameter

Description

Default

figma_url

Figma node URL with node-id

required

icons_dir

Absolute path to icons folder

required

dry_run

Preview without writing files

false

copy_existing

Write similar icons with -copy suffix instead of skipping

false

Dry run (preview only)

Extract icons — dry run only, don't write files.

figma_url: https://www.figma.com/design/xxx?node-id=1234-5678
icons_dir: /Users/you/project/src/components/icons
dry_run: true

Convert a single SVG

Convert this SVG to an icon component and save it.

icon_name: arrow-right
icons_dir: /Users/you/project/src/components/icons
svg_code: <svg viewBox="0 0 24 24">...</svg>

How icon detection works

Icons are identified by:

  • Type: INSTANCE, COMPONENT, VECTOR, or BOOLEAN_OPERATION

  • Name: kebab-case pattern — wallet-03, arrow-right, x-close ✅

    • Excluded: Frame 123, Group, Solid, Bold, Featured icon ❌

  • Size: Square dimensions in common icon sizes: 12, 14, 16, 18, 20, 24, 28, 32, 36, 40, 48, 64px

Duplicate detection

Before writing a file, the server checks your existing icons folder using:

  1. Name similarity — fuzzy match on component name (70%+ threshold)

  2. SVG path similarity — Jaccard similarity on path data (85%+ threshold)

If either matches, the icon is skipped (or written with -copy suffix if copy_existing: true).

Tools

Tool

Description

extract_icons_from_figma

Main tool — extracts icons from a Figma URL

svg_to_icon

Convert a raw SVG string to a TSX component

Contributing

Issues and PRs welcome at https://github.com/Pruthvik1/figma-svg-to-icon-mcp.

License

MIT

Available Tools

2 tools
extract_icons_from_figmaA

Extract all SVG icons from a Figma node URL and save new ones as TSX components. Uses the Figma REST API directly — handles deep/nested nodes including instances. Checks existing icons folder and skips duplicates. Parameter is figma_url (not figma_node_url).

Inputs: figma_url (required), icons_dir (required), dry_run, copy_existing.

svg_to_iconA

Convert raw SVG code into a TSX icon component and optionally write it to your icons folder.

Inputs: svg_code (required), icon_name (required), dry_run, icons_dir.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools are clearly distinct: one extracts icons from Figma via URL, the other converts raw SVG code. No overlap in input methods, making selection unambiguous.

    Naming Consistency3/5

    Naming is mixed: 'extract_icons_from_figma' follows a verb-object-source pattern, while 'svg_to_icon' is a transformation phrase without a verb. Both use snake_case, but the semantic patterns differ.

    Tool Count3/5

    Only two tools exist, which is borderline per the rubric. However, the server's narrow purpose (Figma to icon conversion) is directly served by these two operations, so the count is reasonable.

    Completeness5/5

    The two tools cover the entire conversion pipeline: batch extraction from Figma and single conversion from raw SVG. Duplicate checking and file writing are included, leaving no obvious gaps for the stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Automates the conversion of Figma designs into TypeScript React components and integrates with GitHub to create pull requests for the generated code. It includes visual regression testing with Playwright and accessibility validation to ensure implementations match the original designs.
      5
      29 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI coding tools to search, inspect, recommend, and export SVG icons from svgicons.com for use in design systems, frontend projects, and AI-assisted workflows.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables developers to extract and organize Figma design files, including complete node data (tree structure and images) for AI understanding and code generation.
      23 PyPI
      MIT