icon-composer-mcp — Claude Code MCP server: setup and tools
Generates Apple .icon asset bundles with Liquid Glass styling from SVG and PNG inputs. Helps mobile developers prepare application icons and App Store graphics directly through AI agents.
claude mcp add icon-composer-mcp -- npx -y icon-composer-mcpWhat icon-composer-mcp does
The server gives AI agents 12 tools and 3 structured workflow prompts to handle application icons. It accepts SVG or PNG inputs to assemble .icon bundles for Xcode projects, configuring layer scale, background fills, and positioning. It also handles Liquid Glass properties such as specular highlights, material blur, translucency, and shadows, alongside appearance overrides for dark mode.
Packaging bundles and exporting flat 1024x1024 marketing graphics work across platforms with Node.js 18+. Full glass rendering requires macOS with Apple's Icon Composer installed via Homebrew. Without the native ictool utility, pixel-perfect Liquid Glass rendering will not execute.
What it helps with
- generate
.iconasset bundles from SVG or PNG glyphs - configure Liquid Glass material blur, shadows, and highlights
- set up custom appearance overrides for dark mode icons
- export 1024x1024 flat PNG assets for App Store Connect submission
Example prompts for the agent
- Create a new
.iconbundle usinglogo.svgwith background color#0A66C2 - Adjust Liquid Glass translucency and specular highlights on the main layer
- Export a 1024x1024 marketing PNG without alpha transparency for App Store Connect
How to install icon-composer-mcp
Platform CLI
claude mcp add icon-composer-mcp -- npx -y icon-composer-mcpPlatform CLI
codex mcp add icon-composer-mcp -- npx -y icon-composer-mcpConfig file
{
"mcpServers": {
"icon-composer-mcp": {
"command": "npx",
"args": [
"-y",
"icon-composer-mcp"
]
}
}
}Config file
{
"servers": {
"icon-composer-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"icon-composer-mcp"
]
}
}
}Platform CLI
gemini mcp add icon-composer-mcp npx -y icon-composer-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about icon-composer-mcp
How to install icon-composer-mcp in Claude Code?
Run claude mcp add icon-composer-mcp -- npx -y icon-composer-mcp. This registers the server and exposes its tools to the assistant.
What does icon-composer-mcp do?
It coordinates icon packaging for Apple platforms, managing layer scales, dark mode styling, and Liquid Glass visual parameters.
Does icon-composer-mcp require macOS?
You can assemble bundles and export flat PNGs on any OS with Node.js 18+. Full glass effects require macOS with brew install --cask icon-composer to access the ictool renderer.
