Imagic MCP server

imagic MCP server

The first photo editor with a built-in MCP server.

imagic is a desktop photo editor for Windows and macOS with AI culling, a full non-destructive editor, and style learning. Its MCP (Model Context Protocol) server is built into the app, so Claude Code, Claude Desktop, Cursor, Codex, GitHub Copilot, or any other MCP client can drive the whole pipeline: scan a shoot, cull it, edit it in your style, and export the keepers. Everything runs locally on your machine.

This repository is the documentation and setup reference for that server. The server itself ships inside the imagic desktop app; there is no separate server source here.

• Full guide: imagic.ink/mcp
• Scripting without an AI client: imagic.ink/automation
• Download: imagic.ink/desktop

What an agent can do with it

Once connected, the agent calls the same actions you would trigger by hand in the app. Things you can actually say:

• "Scan D:/Shoots/june-wedding, cull it, and tell me what you kept and why."
• "Make the keepers warmer and export them to D:/delivery."
• "Run my film preset over the golden hour frames."
• "Edit the whole shoot like I would." (after style calibration)
• "I edited five from this wedding, match the rest to them."
• "Actually, just keep the best 60 for the client gallery." (instant re-rank, no re-analysis)
• "Export the keepers as full-res JPEGs."

Edits land as non-destructive adjustments in imagic's edit history, the same as manual edits. Nothing overwrites your originals unless you explicitly export.

Install

1. Download imagic from imagic.ink/desktop. The free trial covers 500 exports with everything in imagic Max, no card required (importing, culling and editing never count against it).
2. Launch the app once and activate (trial or license). The MCP server reuses that activation.
3. Connect your MCP client (below).

The server is the imagic app itself, started with --mcp. There is no pip package and no separate imagic-mcp command in the packaged app; point your client at the installed binary:

• Windows: C:\Program Files\imagic\imagic.exe
• macOS: /Applications/imagic.app/Contents/MacOS/imagic

Per-client setup for fourteen clients (config file locations, the right config key for each) is at imagic.ink/mcp/setup.

Claude Code

claude mcp add imagic -- "C:\Program Files\imagic\imagic.exe" --mcp

On macOS:

claude mcp add imagic -- /Applications/imagic.app/Contents/MacOS/imagic --mcp

Claude Desktop, Cursor and other JSON-config clients

Add this to the client's MCP config (claudedesktopconfig.json for Claude Desktop):

{
  "mcpServers": {
    "imagic": {
      "command": "C:\Program Files\imagic\imagic.exe",
      "args": ["--mcp"]
    }
  }
}

On macOS use "command": "/Applications/imagic.app/Contents/MacOS/imagic" with the same "args": ["--mcp"].

Codex CLI

codex mcp add imagic -- "C:\Program Files\imagic\imagic.exe" --mcp

Or in ~/.codex/config.toml:

[mcp_servers.imagic]
command = 'C:\Program Files\imagic\imagic.exe'
args = ["--mcp"]

GitHub Copilot and any other MCP-compatible client work the same way: a local stdio server whose command is the imagic binary with --mcp.

The 21 tools

Shortened. The full README is on GitHub.