SSyncDev

Icon MCP Server

CLI and MCP server for creating Apple .icon bundles with Liquid Glass effects (iOS 26+)

Local serverstdio

What is the Icon MCP Server?

CLI and MCP server for creating Apple .icon bundles with Liquid Glass effects (iOS 26+)

The short version

  • Create .icon bundles — programmatically from PNG or SVG glyphs
  • Full Liquid Glass — support: specular highlights, blur material, shadows, translucency
  • Dark mode + appearance variants — with per-appearance fill specializations
  • AI-agent ready — 12 MCP tools + 3 workflow prompts with built-in instructions

What it needs from you

  • Node.js 18+ - macOS with Icon Composer for Liquid Glass rendering - Flat previews, bundle creation/editing, and marketing export work on any platform without Icon Composer Run icon-composer doctor to check your setup.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
createCreate a new .icon bundle from a foreground image
add-layerAdd a layer to an existing bundle
removeRemove a layer or group
inspectRead and display bundle contents
glassConfigure Liquid Glass effects on a group
appearanceSet dark/tinted mode overrides
fillSet background fill (solid, gradient, automatic, none)
positionSet layer/group scale and offset
previewExport a preview PNG (Liquid Glass or flat)
renderRender pixel-perfect Liquid Glass via ictool
export-marketingExport flat 1024x1024 PNG for App Store Connect (no alpha)
doctorCheck system setup and dependencies
create_iconCreate a .icon bundle from a foreground image and background color
add_layer_to_iconAdd a new layer to an existing bundle

How to install the Icon MCP Server

{
  "mcpServers": {
    "icon-composer": {
      "command": "npx",
      "args": ["-y", "icon-composer-mcp"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Node.js 18+ - macOS with Icon Composer for Liquid Glass rendering - Flat previews, bundle creation/editing, and marketing export work on any platform without Icon Composer Run icon-composer doctor to check your setup.

Example prompts to try

  • “Use Icon to create.”
  • “Use Icon to add-layer.”
  • “Use Icon to remove.”

Frequently asked questions

CLI and MCP server for creating Apple .icon bundles with Liquid Glass effects (iOS 26+) Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.