list_media
Page through the Google Photos library timeline, newest first: media key, taken/uploaded time, dimensions, photo or video (+duration), favorite flag and a thumbnail URL. Optional date range (after/before) and type filter. Pass next_page_token to continue.
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": {
"google_account_email": "<google_account_email>"
},
"name": "list_media"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| after | No | Only items taken on/after this time: YYYY-MM-DD, ISO-8601 UTC, or epoch ms. | |
| before | No | Only items taken on/before this time (a bare date includes the whole day). | |
| page_size | No | Target number of items, 1-500 (default 100). Google pages in its own chunk sizes, so a call can return somewhat more; keep paging with next_page_token. | |
| media_type | No | Filter by type. Default all. | |
| page_token | No | next_page_token from the previous list_media call. | |
| google_account_email | Yes | The signed-in Google account email whose Google Photos library to use (e.g. the one at /u/1/). Call list_accounts first and confirm with the user; do not guess. | |
| notification_message | No | Short user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names. |