search_smart
Search your photo library using natural language descriptions of visual content, with optional location and date filters to narrow results.
Instructions
AI-powered visual search using CLIP embeddings. Use this when describing what a photo looks like in natural language (e.g. 'sunset at the beach', 'dog playing fetch'). For structured criteria (city, camera, date), use search_metadata instead. Requires Immich ML service with Smart Search enabled. Read-only.
Args:
query: Natural language description of the visual content to find.
city: Optional city filter to narrow results geographically.
state: Optional state/region filter.
country: Optional country filter.
taken_after: ISO date — only assets captured after this date.
taken_before: ISO date — only assets captured before this date.
page: Page number, starting from 1 (default 1).
size: Results per page (1-200, default 50).
Returns: JSON with total count, page, and assets ranked by visual similarity to the query.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| city | No | ||
| state | No | ||
| country | No | ||
| taken_after | No | ||
| taken_before | No | ||
| page | No | ||
| size | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |