Connect imagic to Cursor

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 Cursor 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 Cursor

Cursor has no documented add command. Create the file below, then enable imagic under Customize.

Configuration

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

{
  "mcpServers": {
    "imagic": {
      "type": "stdio",
      "command": "imagic-mcp"
    }
  }
}

Where that file lives

Where to find it in the interface

Customize in the Cursor sidebar, where servers can be enabled, disabled and installed.

3Ask for a cull

Restart Cursor 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.

Cursor 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

• Cursor's own docs contradict themselves on the type field: the table marks it required, the examples omit it. Including it satisfies both readings, which is why it is in the snippet above.
• Cursor asks for approval before running a tool by default.
• Cursor documents this path in tilde form only and publishes no Windows-specific 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 Anysphere's documentation. If Cursor changes its setup and this page falls behind, tell us and we will fix it.