search_photos
Find photos and videos in an Apple Photos library by text, album, person, keyword, place, date range, favorite status, or media type, with newest results first.
Instructions
Find photos and videos, newest first. All filters are optional and combine with AND.
text matches title, description, filename, people, keywords, albums, labels and place.
Dates are ISO (YYYY-MM-DD, optionally with a time) in the photo's local time; to_date
includes that whole day. album, person and keyword are exact names, ignoring case.
Returns the total number of matches and up to `limit` (max 100) of them.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_photos"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | ||
| album | No | ||
| limit | No | ||
| place | No | ||
| person | No | ||
| keyword | No | ||
| to_date | No | ||
| favorite | No | ||
| from_date | No | ||
| media_type | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||