Log inSubmit server
Icon Composer MCP logo

Icon Composer MCP

by ethbak

Create, edit, inspect, render, and export Apple .icon bundles with Liquid Glass and appearance controls.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Icon Composer MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "ethbak-icon-composer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "icon-composer-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

ethbak/icon-composer-mcp MCP server exposes Apple Icon Composer workflows through 12 MCP tools for creating and editing .icon bundles. It accepts image assets, writes bundle manifests and layers, configures fills, Liquid Glass effects, positions, and appearance variants, then produces previews or marketing exports. macOS with Icon Composer is required for ictool-based Liquid Glass rendering, while bundle editing and flat exports work on any platform. Reach for it when an agent needs to generate or modify app icons programmatically rather than operating Icon Composer manually.

Use cases

  • Create app icon bundles from PNG or SVG glyphs
  • Tune Liquid Glass effects for iOS 26+ icons
  • Generate dark and tinted appearance variants
  • Inspect and modify existing .icon bundles
  • Export preview and App Store marketing images

Key features

  • Create and edit Apple .icon bundles
  • Configure Liquid Glass effects
  • Set dark and tinted appearance overrides
  • Render preview and marketing PNGs
  • Inspect bundle manifests and assets
  • Run through stdio with MCP clients

Tools12

What Icon Composer MCP lets your agent do. Expand a tool for its parameters.

Self-reported~158 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

21/21 checks healthy over the last 80d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 12d ago via OSV.dev · icon-composer-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars62Stargazers on the source repository.
npm downloads570Package downloads in the last 30 days.
Last commit25d agoMost recent push to the default branch.
Tools exposed12Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Icon Composer MCP works

What ethbak/icon-composer-mcp MCP server does

The ethbak/icon-composer-mcp MCP server provides an MCP interface for Apple Icon Composer bundle workflows. It can create a .icon bundle from a foreground image and background color, add or remove layers and groups, inspect the manifest and asset files, and modify the visual properties stored in the bundle.

The server supports PNG and SVG glyphs for initial bundle creation. Additional layers can use PNG, JPG, JPEG, SVG, WebP, HEIC, or HEIF files. A bundle can contain layer scale, offsets, opacity, blend modes, and participation in Liquid Glass effects. The project also provides three workflow prompts with built-in instructions, in addition to its tools.

How it works

An agent supplies an input image and output location to create a bundle. The server writes a .icon directory containing an icon.json manifest and an Assets directory. Subsequent calls can target that bundle to change its layers, fill, position, appearance overrides, or effects.

Liquid Glass settings include specular highlights, blur material, shadows, and translucency. Appearance controls cover dark and tinted mode overrides, including per-appearance fill specializations. Glass effects can also be enabled or disabled together. Preview rendering can produce PNG output, while the marketing export creates a flat, opaque 1024-by-1024 PNG for App Store Connect.

The ethbak/icon-composer-mcp MCP server can use Apple’s ictool for Liquid Glass rendering when Icon Composer is installed on macOS. This path is intended for pixel-level Liquid Glass output. Flat previews, bundle creation and editing, and marketing export do not require Icon Composer and work on any platform.

Setup and configuration

The ethbak/icon-composer-mcp MCP server requires Node.js 18 or newer. It runs over stdio and can be launched with npx -y icon-composer-mcp. MCP clients generally configure the command as npx with -y and icon-composer-mcp as arguments.

The README includes setup examples for Claude Code, Claude Desktop, Cursor, VS Code, and Windsurf. VS Code uses a servers object, a stdio type, and the command and argument fields; the other examples use the client configuration format shown in the project documentation. The package can also be installed globally for CLI-only use with npm install -g icon-composer-mcp.

For Liquid Glass rendering, install Icon Composer on macOS, for example with brew install --cask icon-composer. The icon-composer doctor command checks the local setup and dependencies.

Tools and capabilities

The MCP tool set includes:

  • Create, inspect, and update .icon bundles.
  • Add layers or groups and remove existing layers or groups, with optional asset cleanup.
  • Set background fills, including solid, gradient, automatic, or no fill.
  • Adjust layer and group scale and X/Y offsets.
  • Configure specular, blur, shadow, and translucency behavior.
  • Apply dark or tinted appearance overrides.
  • Toggle all glass effects on or off.
  • Export preview PNGs, render Liquid Glass through ictool, and export an opaque App Store marketing PNG.

Limitations and notes

Liquid Glass rendering through Apple’s ictool depends on macOS and an installed Icon Composer release. The project states that it is not affiliated with Apple. The server is also available as a CLI, so it can be used without MCP when an agent connection is not needed.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Icon Composer MCP

ethbak/icon-composer-mcp is an MCP server that connects AI agents to Apple Icon Composer workflows through tools for creating, editing, inspecting, rendering, and exporting .icon bundles. Its main tools manage layers, fills, Liquid Glass effects, appearance variants, previews, and App Store marketing PNGs.

Install it by configuring an MCP client to run `npx -y icon-composer-mcp`. The README provides configurations for Claude Code, Claude Desktop, Cursor, VS Code, and Windsurf. Node.js 18 or newer is required; global installation is also available for CLI-only use.

Yes, ethbak/icon-composer-mcp works with Cursor through its stdio MCP configuration. Add the server to `.cursor/mcp.json` in a project or to `~/.cursor/mcp.json` globally, using `npx` with `-y icon-composer-mcp` as the arguments.

Yes, macOS with Apple Icon Composer is required for Liquid Glass rendering through `ictool`. Bundle creation and editing, flat previews, and marketing export work on any platform without Icon Composer. The project documents installation through `brew install --cask icon-composer`.

Yes, it can export a flat, opaque 1024-by-1024 PNG for App Store Connect. The marketing export does not use an alpha channel and does not require Icon Composer.

Related MCP servers

All in Architecture & Design All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewIcon Composer MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/ethbak-icon-composer-mcp?style=directory)](https://allmcps.com/mcp/ethbak-icon-composer-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/ethbak-icon-composer-mcp"><img src="https://allmcps.com/api/badge/ethbak-icon-composer-mcp?style=directory" alt="Icon Composer MCP on AllMCPs" /></a>