List My Playlists
youtube_list_playlistsRead-onlyIdempotent
List all playlists owned by your YouTube channel with support for pagination and adjustable result count.
Instructions
List all playlists belonging to the authenticated channel.
Args
maxResults(integer 1–50, default 25): Number of playlists to return per page.pageToken(string, optional): Pagination cursor from a previous call'snextPageToken.response_format("markdown" | "json", default "markdown"): Output format.
Returns JSON shape:
{
"playlists": [
{
"id": "PL...",
"title": "My Playlist",
"description": "...",
"privacyStatus": "public" | "private" | "unlisted",
"itemCount": 12,
"publishedAt": "2024-01-01T00:00:00Z"
}
],
"nextPageToken": "...",
"totalResults": 42
}Examples
List first page:
youtube_list_playlists()Page 2:
youtube_list_playlists({ pageToken: "..." })
Errors
401/403 → re-run
npm run auth; check OAuth scopes.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| maxResults | No | Number of playlists to return (1–50, default 25). | |
| pageToken | No | Pagination cursor returned from a previous call. | |
| response_format | No | Output format: "markdown" (default) or "json". | markdown |