SF Symbols MCP
Provides tools to search, retrieve metadata, and export Apple SF Symbols as vector SVGs using Apple's private CoreUI framework and system asset catalog.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SF Symbols MCP Export the 'star.fill' symbol as SVG with bold weight"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 CoreTextInstall Python dependencies
Requires uv:
uv syncUse 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 SF Symbol names by name or keyword |
| Get availability, related symbols, and renderability info |
| Export a symbol as vector SVG with weight/size options |
| List available SF Symbol names |
Export Options
Parameter | Default | Description |
| required | SF Symbol name (e.g. |
|
| ultralight, thin, light, regular, medium, semibold, bold, heavy, black |
|
| Point size for rendering |
| none | File path to save SVG (returns content if omitted) |
|
| 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 50How It Works
MCP Server (Python) Swift CLI
───────────────── ─────────────────────────────
FastMCP tool handlers → CoreUI private framework
├── CUICatalog (Assets.car)
├── CUINamedVectorGlyph
└── CGPath → SVG path dataSF 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 toolsexport_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
Scored across 4 tools
Each tool has a clearly distinct purpose: exporting SVGs, getting symbol info, listing all symbols, and searching by keyword. No overlap in functionality.
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.
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.
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
Unofficial Iconify MCP — wraps the Iconify public API (free, no auth)
A coding agent searches the Icons8 library by keyword and style, then adds the selected icon or illustration to the project. Icons8 draws all of it: 420,000+ icons (130+ styles) and 110,000+ illustrations (340+ styles), so one project doesn't end up with mixed looks. The server lives at https://mcp.icons8.com/mcp/ and signs people in through their Icons8 account in the browser. Downloading PNG is free as long as the project links back to Icons8. SVG is on the paid plan, and that plan makes the link optional.
Search open SVG icon packs and fetch exact SVG markup from coding agents through MCP.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP server that allows FE/UI/Designers to retrieve SVG icons via the Iconify API by simply asking LLMs rather than manually searching websites.321 npm4MIT
- AlicenseNot gradedqualityDmaintenanceAI-powered SVG icon generation MCP server. Generate production-ready SVG icons from text descriptions with customizable styles, sizes, and themes.108 npm8MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol server for searching and fetching icons from iconfont.cn.328 npm9MIT
- AlicenseAqualityDmaintenanceA Model Context Protocol (MCP) server for semantic SVG icon search. Generate infographic SVG icons by keyword — over 100,000 icons with semantic search support.112 npm1MIT