Skip to main content
Glama
SF Symbols MCP

SF Symbols MCP

by ygrec-app

SF Symbols MCP

MCP server for searching and exporting Apple SF Symbols as true vector SVGs.

SF Symbols MCP lets AI agents and developers search the full SF Symbols catalog, get symbol metadata, and export any symbol as a vector SVG — real bezier paths, not rasterized images. It uses Apple's private CoreUI framework to extract the actual glyph data from the system asset catalog.


Quick Start

Build

Requires macOS 14+ with Xcode or Command Line Tools installed.

git clone https://github.com/ygrec-app/sf-symbols-mcp.git
cd sf-symbols-mcp
swiftc sf_symbol_cli.swift -o sf-symbol-cli -framework AppKit -framework CoreText

Install Python dependencies

Requires uv:

uv sync

Use with Claude Code (MCP)

Add to your project-level .mcp.json:

{
  "mcpServers": {
    "sf-symbols": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/sf-symbols-mcp",
        "python",
        "server.py"
      ]
    }
  }
}

Replace /path/to/sf-symbols-mcp with the actual path where you cloned the repo.

Then ask Claude: "Find me an SF Symbol for notifications" or "Export the star.fill symbol as SVG."


Related MCP server: icogenie-mcp

MCP Tools

Tool

Description

search_symbols

Search SF Symbol names by name or keyword

get_symbol_info

Get availability, related symbols, and renderability info

export_symbol

Export a symbol as vector SVG with weight/size options

list_symbols

List available SF Symbol names

Export Options

Parameter

Default

Description

name

required

SF Symbol name (e.g. star.fill, chevron.right)

weight

regular

ultralight, thin, light, regular, medium, semibold, bold, heavy, black

size

100

Point size for rendering

output_path

none

File path to save SVG (returns content if omitted)

raw_coords

false

Output raw CoreGraphics Y-up coordinates instead of standard SVG Y-down

Use from CLI

The Swift CLI can also be used directly:

./sf-symbol-cli search star
./sf-symbol-cli export star.fill --weight bold --size 200
./sf-symbol-cli export chevron.right --output ./icons/chevron.svg
./sf-symbol-cli info heart.fill
./sf-symbol-cli list --limit 50

How It Works

MCP Server (Python)          Swift CLI
─────────────────           ─────────────────────────────
FastMCP tool handlers  →    CoreUI private framework
                            ├── CUICatalog (Assets.car)
                            ├── CUINamedVectorGlyph
                            └── CGPath → SVG path data

SF Symbols are stored as vector glyphs in Apple's compiled asset catalog (Assets.car) inside the SFSymbols private framework. The Swift CLI uses Objective-C runtime bridging to access CUICatalog and extract CGPath bezier data, which is then converted to SVG <path d="..."> elements.

The output is true vector SVG (~1-2KB) with actual bezier curves — not rasterized PNG embedded in SVG.


Requirements

  • macOS 14+ (Sonoma or later)

  • Xcode or Command Line Tools (for Swift compiler)

  • Python 3.13+ with uv

  • SF Symbols are built into macOS — no additional installation needed


License

MIT

Available Tools

4 tools
export_symbolA

Export an SF Symbol as SVG with vector paths.

Args: name: SF Symbol name (e.g. "star.fill", "circle", "chevron.right") weight: Font weight — ultralight, thin, light, regular, medium, semibold, bold, heavy, black size: Point size for rendering (default 100) output_path: Optional file path to save the SVG. If not provided, returns SVG content. raw_coords: If True, output raw CoreGraphics coordinates (Y-up) instead of standard SVG (Y-down). Use this for design tools like Pencil that use Y-up coordinate systems.

Returns: SVG content or confirmation of file save.

Inputs: name (required), size, weight, raw_coords, +1 more. Returns: result

get_symbol_infoA

Get information about a specific SF Symbol.

Args: name: Exact SF Symbol name (e.g. "star.fill", "circle", "arrow.right")

Returns: JSON with symbol availability, related symbols, and renderability.

Inputs: name (required). Returns: result

list_symbolsA

List available SF Symbol names.

Args: limit: Maximum number of symbols to return (default 100)

Returns: JSON with total count and symbol names.

Inputs: limit. Returns: result

search_symbolsA

Search for SF Symbol names by name or keyword.

Args: query: Search term (e.g. "star", "circle", "arrow", "weather", "music")

Returns: JSON with matching symbol names and count.

Inputs: query (required). Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: exporting SVGs, getting symbol info, listing all symbols, and searching by keyword. No overlap in functionality.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with underscores (export_symbol, get_symbol_info, list_symbols, search_symbols), making them predictable and easy to understand.

    Tool Count5/5

    With 4 tools, the server covers the essential operations for SF Symbols: listing, searching, retrieving details, and exporting. The count is appropriate for the domain.

    Completeness4/5

    The tool set covers querying (list/search/info) and exporting (SVG) adequately. A minor gap could be the lack of a 'preview' tool, but export serves that need. Overall, no critical missing operations for typical use.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      MCP server that allows FE/UI/Designers to retrieve SVG icons via the Iconify API by simply asking LLMs rather than manually searching websites.
      3
      21 npm
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      AI-powered SVG icon generation MCP server. Generate production-ready SVG icons from text descriptions with customizable styles, sizes, and themes.
      108 npm
      8
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server for semantic SVG icon search. Generate infographic SVG icons by keyword — over 100,000 icons with semantic search support.
      1
      12 npm
      1
      MIT