What it does
Filter by status (pending, keep, trash, culled, exported, error) or omit it for everything. Use limit and offset to page through large libraries; the response includes the total match count. Photo ids from this list are what every per-photo tool expects.
Parameters
| Name | Type | Required |
|---|---|---|
status |
str | None |
optional |
limit |
int |
optional |
offset |
int |
optional |
Asking for it
You do not call this by name. You say what you want, and the agent picks the tool:
Cull the wedding shoot in D:/Shoots/eva_tom, keep the best frames, and tell me what you dropped.
The rest of the library tools
Workflows that use it
- Cull a wedding shoot with AI — AI wedding photo culling
- Pick and export a client gallery — AI select best photos client gallery
- Find duplicate and near-duplicate photos — find duplicate photos automatically
- Score and rank photos automatically — automatic photo quality scoring
Where it runs
On your machine. imagic's MCP server is a local process that your AI client starts; the photos never leave your disk and nothing is uploaded. That is true of every tool in the reference, including this one.
To call it you need an MCP client connected to imagic. Setup takes about three minutes for Claude Code, Cursor, VS Code, Codex, Gemini CLI and ten others.
Give your AI the whole pipeline
list_photos is one of 18 tools in imagic Max. The free 7-day trial includes all of them.