Smart Photo Search
photos_smart_searchRead-onlyIdempotent
Search and filter Google Photos by content categories and date range. Specify user email, include photos or videos, and set result limits.
Instructions
Advanced photo search with smart filtering and optimization
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date_end | No | End date in YYYY-MM-DD format. | |
| date_start | No | Start date in YYYY-MM-DD format. | |
| max_results | No | Maximum results to return. Defaults to 50. | |
| include_photos | No | Include photos in results. Defaults to True. | |
| include_videos | No | Include videos in results. Defaults to False. | |
| user_google_email | No | The user's Google email address for Photos access. If None, uses the current authenticated user from FastMCP context (auto-injected by middleware). | |
| content_categories | No | Content categories (PEOPLE, ANIMALS, FOOD, etc.). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Error message if search failed | |
| success | No | Whether the search operation succeeded | |
| user_email | No | Email address of the user who performed the search | |
| cache_stats | No | Cache statistics including size, hits, and performance metrics | |
| media_items | No | List of photos matching the search criteria | |
| total_found | No | Total number of matching photos found | |
| text_summary | No | Human-readable summary of search results | |
| filters_applied | No | Search filters that were applied (categories, dates, media types) | |
| search_time_seconds | No | Time taken for the search operation in seconds |