Search smart
search_smartRead-only
Find photos by describing their visual content in natural language, using CLIP embeddings to match queries to images and rank results by similarity.
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.
ocr: Text recognized inside the image, combined with the visual query.
Needs OCR enabled on the server — check with get_capabilities.
person_ids: Only assets showing ALL of these people (ids from list_people).
tag_ids: Only assets carrying these tags (ids from list_tags).
album_ids: Only assets inside these albums.
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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_smart"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ocr | No | ||
| city | No | ||
| page | No | ||
| size | No | ||
| query | Yes | ||
| state | No | ||
| country | No | ||
| tag_ids | No | ||
| album_ids | No | ||
| person_ids | No | ||
| taken_after | No | ||
| taken_before | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |