yt-playlist-organizer-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YOUTUBE_API_KEY | No | Google API key. Enables public reads (playlists_list, playlistItems_list). | |
| YOUTUBE_ACCESS_TOKEN | No | OAuth2 access token. Required for write tools and mine=true. Can be used instead of or in addition to an API key. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| playlists_listA | Get YouTube playlists. Requires exactly one filter: id, channelId, or mine=true (mine=true requires an OAuth access token, not an API key). Quota cost: 1 unit. |
| playlists_insertA | Create a YouTube playlist (requires title). Quota cost: 50 units. Requires OAuth access token. |
| playlists_updateA | Modify a YouTube playlist (id and title required; overrides snippet). If description or privacyStatus are omitted their current values are preserved. Quota cost: 50 units. Requires OAuth access token. |
| playlists_deleteA | Delete a YouTube playlist. Quota cost: 50 units. Requires OAuth access token. |
| playlistItems_listA | Get items in a YouTube playlist. Requires exactly one filter: playlistId or id. If both are omitted the call is rejected. Quota cost: 1 unit. |
| playlistItems_insertA | Add a video (videoId) to a playlist (playlistId). startAt/endAt are in seconds and converted to ISO 8601 durations. Quota cost: 50 units. Requires OAuth access token. |
| playlistItems_updateA | Modify a playlist item (e.g. its position). Omitted snippet/contentDetails fields are preserved. Quota cost: 50 units. Requires OAuth access token. |
| playlistItems_deleteA | Remove a playlist item from a playlist. Quota cost: 50 units. Requires OAuth access token. |
| auth_statusA | Check whether API key and/or OAuth access token are configured. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Each tool targets a distinct resource (playlists vs playlistItems) and action, with clear separation between auth status checks and CRUD operations. No two tools overlap in purpose.
The verb_noun pattern (e.g., playlists_list, playlistItems_delete) is consistent, but the use of camelCase in 'playlistItems' vs lowercase 'playlists' and the snake_case 'auth_status' cause minor inconsistency.
Nine tools is well within the ideal range for a focused server, covering playlist and playlist item CRUD plus authentication checks without bloat.
Full CRUD for both playlists and playlist items is provided, along with auth status, covering the core workflows of a playlist organizer. Minor missing features like reordering are handled via update.