Icon Composer MCP
MCP server and CLI building .icon bundles with Liquid Glass for iOS 26: layers, dark mode, previews, App Store export
- 72 ★ on the repository
- Last commit
Extended access
Why this level
- Reads source PNG and SVG files and writes .icon bundles and previews at paths the assistant supplies
- Installs from npm and calls Apple ictool on macOS
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/icon-composer-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Reads source PNG and SVG files and writes .icon bundles and previews at paths the assistant supplies
- Installs from npm and calls Apple ictool on macOS
This is third-party code. Review the repository files before installing.
What it does
Icon Composer MCP creates .icon bundles that Apple Icon Composer and Xcode read. The server gives an assistant twelve tools: create a bundle from a PNG or SVG and a background color, add or remove a layer, read the manifest, configure specular highlight, blur, shadows and translucency, set the fill and layer position, define overrides for dark and tinted appearances and switch all effects off at once. Three ready workflows guide the tasks: create an app icon, add dark mode, export an icon for the App Store. There are three ways to get an image. A flat preview builds on any platform. render_liquid_glass computes real glass through Apple Icon Composer ictool, which needs macOS and the icon-composer cask from Homebrew. export_marketing produces a flat 1024 by 1024 PNG without an alpha channel for App Store Connect. The same functions are available through the icon-composer command (create, add-layer, glass, appearance, fill, position, preview, render, export-marketing, doctor). icon-composer doctor checks the environment.
Who it is for. iOS developers and designers who build app icons for Liquid Glass and want to run that work through an assistant or scripts.
Good fit when
- An app has an SVG logo and you need an .icon bundle with a brand fill and a specular highlight
- A finished icon gets dark mode with a different fill color and is previewed before and after
- App Store Connect needs a flat 1024 by 1024 PNG without transparency
- An icon is built from several layers and the glass is configured for each group separately
- Icons are generated by a script in CI with the icon-composer command and no MCP
Not a fit when
- You need a finished icon from scratch: the server styles your image and cannot draw a glyph
- You need an Android or web icon: the .icon format belongs to iOS 26 and Xcode
- You need a Liquid Glass render without a Mac: only ictool from Icon Composer computes real glass
- You need the transparent ClearLight and ClearDark variants: through the CLI they render on a gray background
Example request
Build an icon from logo.svg with a blue fill #0A66C2, add a dark appearance with fill #0B1220, show a preview and export the PNG for the App StoreMCP
- Transport
- stdio
- Authentication
- not required
Limitations
- Liquid Glass rendering works only on macOS with Apple Icon Composer installed (brew install --cask icon-composer). Flat previews, bundle creation and editing and store export work everywhere.
- The ClearLight and ClearDark variants render on a gray background: glass transparency needs the Metal GPU, which is unavailable from the command line.
- Node.js 18 or newer is required.
- The project is not affiliated with Apple, as the author states in the README.
- The license is MIT.
How to disable. In Claude Code claude mcp remove icon-composer removes the server, and in other clients the icon-composer entry is deleted from the MCP config. The global CLI is removed with npm uninstall -g icon-composer-mcp. Created .icon bundles stay on disk.
FAQ
How do I connect Icon Composer MCP to Claude Code?
Run claude mcp add icon-composer -- npx -y icon-composer-mcp. For Cursor, VS Code and Windsurf the README has ready config snippets with the same npx call.
Do I need a Mac to use the server?
For real Liquid Glass you do: rendering goes through ictool from Apple Icon Composer. Creating and editing .icon bundles, making flat previews and exporting the App Store PNG works on any platform.
How do I get an icon for App Store Connect?
The export_marketing tool or the icon-composer export-marketing command produces a flat 1024 by 1024 PNG without an alpha channel. The .icon bundle itself goes into the Xcode project asset catalog.
Which glass effects can be configured?
Specular highlight, blur material, shadow (neutral, layer color or none) and translucency. The toggle_fx tool switches all effects on and off in one call.
Can I use it without MCP?
Yes, the package installs the icon-composer CLI: npm install -g icon-composer-mcp. It has commands from create to export-marketing and doctor for checking the environment.
Discussion
No questions or reviews yet.
Related
MCP serversA skill that creates, validates and renders Apple Icon Composer .icon packages without opening the graphical app.
An MCP server for Xcode on macOS: the agent creates projects, builds and tests apps, installs dependencies and drives the iOS simulator
Open-source CLI and editor for App Store and Google Play screenshots: 101 templates, agent layout, size checks and agent hookup
An MCP server that takes plain-language commands and drives the iOS Simulator through idb: apps, taps, logs
An MCP server for the iOS Simulator: taps, swipes, text input, accessibility tree, screenshots, video and app control
XC-MCP gives an agent 81 Xcode and iOS Simulator tools and compresses build output into short summaries with details on demand.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Icon Composer MCP (this card) | no | not required | 72 | |
| Apple Liquid Glass | no | 288 | a reference for the SwiftUI Liquid Glass API that does not build .icon bundles | |
| XcodeBuildMCP (now MobileBuildMCP) | yes | not required | 6,565 | building and running Xcode projects, it does not create icons or assets |
README in short
The README begins with a demo and a feature list, then gives connection snippets for Claude Code, Claude Desktop, Cursor, VS Code and Windsurf and a CLI-only install. Next it describes the steps from glyph to Apple ictool, environment requirements, tables of CLI commands and MCP tools with parameters, example workflows and a list of limitations.