List albums
list_albumsDiscover existing photo albums with summary info to find album IDs or check what already exists. Filter by name or shared status, and page results to keep large libraries manageable.
Instructions
List albums in the library with summary info. Use this to discover existing albums before creating new ones or to find an album ID. On a library with thousands of albums, filter with name_contains or page with size instead of listing everything: the full list can be too large for the context. Read-only.
Args:
shared: true = only shared albums, false = only non-shared, omit = all albums.
name_contains: Only albums whose name contains this text (case-insensitive). Omit for all.
page: Page number, starting from 1 (default 1). Only used when size is given.
size: Albums per page (1-500). Omit or 0 = every album in one response (the default).
compact: true = only id, albumName and assetCount per album (smaller response).
Returns: JSON with total count (after the filter), the albums array (each with id, name,
description, assetCount, shared status), and page/size/pages when paging.
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": "list_albums"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| size | No | ||
| shared | No | ||
| compact | No | ||
| name_contains | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |