Connect imagic to Warp

1Install imagic and start the trial

The MCP server ships with imagic Max, and the free 7-day trial unlocks everything with no card. Download it from the desktop page first, because Warp needs something to talk to.

If you installed with pip rather than the packaged app, MCP is an optional extra: pip install imagic[mcp].

2Add imagic to Warp

Add it through Settings, or write the config file below.

Configuration

Warp reads ~/.warp/.mcp.json (global) or .warp/.mcp.json (project). The top-level key is mcpServers.

{
  "mcpServers": {
    "imagic": {
      "command": "imagic-mcp",
      "args": []
    }
  }
}

Where that file lives

Warp publishes this path in ~ form only and documents no Windows expansion, so use the command or the UI above rather than guessing where it lands.

Where to find it in the interface

Settings, then Agents, then MCP servers, then Add, then CLI Server (Command).

3Ask for a cull

Restart Warp if it was already running, then point it at a shoot:

Cull the shoot in D:/Shoots/eva_tom, apply my style, and export the keepers.

Warp will call scan_directory, analyze_photos, apply_my_style and export_photos in turn. Every one of those runs on your machine: the agent sends instructions, never your photos.

Things that catch people out

• Warp also reads other tools' config files, including ~/.claude.json and ~/.codex/config.toml, so imagic may already appear if you set it up elsewhere.
• Server run state persists across restarts: if you stop it, it stays stopped.
• Warp documents these paths in tilde form only, with no Windows expansion.

What imagic can do once it is connected

That is 18 tools in total, covering the library, culling, editing and your learned style. See the full tool reference, or the workflows for what to actually ask for.

Setting up a different client?

Configuration verified against Warp's documentation. If Warp changes its setup and this page falls behind, tell us and we will fix it.