YouTube Music MCP server (stdio) - Rust port of youtube-music-mcp-server, core search/playlist tools only
ytmusic-rs has 13 tools with complete input schemas and descriptions. Naming follows verb_noun convention (authenticate, search, create_playlist). Descriptions are detailed and explain prerequisites (e.g., 'Requires authenticate first'). However, output schemas are not documented, callers cannot see what fields to expect from responses. Parameter descriptions are present but some lack format constraints (e.g., privacy enum values are mentioned in description but not formalized). Error handling is basic, no recovery guidance or actionable error messages visible in the code. The authenticate tool has a notable design: it spawns background OAuth polling and returns the URL immediately, which is good UX but the description could clarify the async nature more explicitly.
Add videos to a playlist. Requires authenticate first.
Check whether we currently hold a stored, usable OAuth token
Start Google OAuth login: returns a URL to open in a browser immediately, then keeps listening in the background (up to 3 minutes) for you to approve access and stores an encrypted token when you do. Call `auth_status` afterward to confirm it completed. Run this once before any playlist/library tool.
Create a new playlist. Requires authenticate first.
Delete a playlist. Requires authenticate first.
Get raw browse data for an album or artist by browse ID (from search results). No auth required. Returns YouTube's raw InnerTube browse response — this port does not re-implement the TS project's full album/artist renderer parsing, so expect to read the JSON structure yourself.
Output schemas not documented. Callers cannot see what fields responses contain, forcing LLMs to guess structure and plan downstream tool calls blindly.
Privacy parameter in create_playlist and update_playlist accepts free-form strings with enum values only mentioned in description text. Should be formalized as an enum constraint in the schema.
No error recovery guidance. Error responses (via to_mcp_err) return raw anyhow::Error messages without actionable next steps or error classification (retryable vs user-fixable vs fatal).
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 61 | <=2025-11-25 | v2 |
List your liked videos ("Liked Music" playlist). Requires authenticate first.
Get items in a playlist. Requires authenticate first.
Get details for a song/video by its YouTube video ID. No auth required.
List your playlists. Requires authenticate first.
Remove videos from a playlist. Requires authenticate first.
Search YouTube Music (songs, videos, albums, artists all mixed together — see result `kind` field). No auth required.
Update a playlist's metadata. Requires authenticate first.
Destructive operations (delete_playlist) lack confirmation or dry-run support. An agent could accidentally delete a playlist without a safety gate.
get_browse_info returns raw YouTube InnerTube JSON without parsing. Description warns callers to 'read the JSON structure yourself', which is poor UX for LLMs and violates the response-shaper pattern.