What it does
name finds photos by file name, the way people refer to them ("DSC04851"): case-insensitive, matches part of the name, and takes several comma-separated names at once. Use it to turn the names a user mentions into the photo ids every other tool expects. taken is when the photo was shot (ISO time from EXIF): the way to group a shoot by day or by evening ("the sunset frames") when there is no description. taken_after / taken_before filter by it (ISO, inclusive; a bare date covers the whole day), for example status="keep", taken_after="2026-09-22T18:00": on a big shoot, filter rather than listing everything. Capture times are read by analyze_photos, so run it before filtering by time; until then the response's note says how many photos have no time yet. 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 |
taken_after |
str | None |
optional |
taken_before |
str | None |
optional |
name |
str | None |
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 30 tools in imagic Max. The free 500-export trial includes all of them.