apple-imagegen-mcp

MCP server for Apple Intelligence — Image Playground, Genmoji, and Writing Tools via AppleScript/Shortcuts.

Requirements

• macOS 15.2+ (Sequoia) with Apple Intelligence enabled
• Apple Silicon Mac (M1 or later)
• Node.js 22+

Install

npm install
npm run build

Usage

npm start

Or register in ~/.mcp.json:

{
  "mcpServers": {
    "apple-imagegen": {
      "command": "node",
      "args": ["/Volumes/Virtual Server/projects/apple-imagegen-mcp/dist/index.js"]
    }
  }
}

Tools (6)

Image Playground

| Tool | Description | |------|-------------| | imagegen_create | Generate an AI image from a text prompt (Animation, Illustration, Sketch) | | imagegen_styles | List available Image Playground styles |

Genmoji

| Tool | Description | |------|-------------| | genmoji_create | Create a custom emoji from a text description |

Writing Tools

| Tool | Description | |------|-------------| | writing_rewrite | Rewrite text (Professional, Friendly, Concise) | | writing_proofread | Proofread text for grammar/spelling | | writing_summarize | Summarize text (key points, paragraph, table of contents) |

Shortcuts Setup

Some tools use Apple Shortcuts as intermediaries. Run the setup checker:

npm run setup-shortcuts

This will show which Shortcuts are installed and provide instructions for creating missing ones.

Required Shortcuts

| Shortcut Name | Used By | |---------------|---------| | AI Generate Image | imagegen_create | | AI Create Genmoji | genmoji_create | | AI Rewrite Text | writing_rewrite | | AI Proofread Text | writing_proofread | | AI Summarize Text | writing_summarize |

Tools with fallback methods (AppleScript/UI automation) will still attempt to work without Shortcuts, but Shortcuts provide more reliable operation.

Architecture

Uses the same pattern as macos-mcp:

• @modelcontextprotocol/sdk for the MCP server
• AppleScript for direct app control
• shortcuts CLI for Shortcuts automation
• Zod for input validation