convez.ai
MCP ServerIntegração & APIsIntermediário
AlexisLaporte

YouTube Music MCP — Gerenciador de Playlists

AlexisLaporte/youtube-music-mcp-unofficial

Organize playlists do YouTube Music via Claude, 100% local

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que conecta Claude diretamente à sua conta YouTube Music para auditar músicas curtidas, organizar playlists e gerenciar sua biblioteca. Roda localmente, sem conta externa ou hospedagem. Usa a API não-oficial do YouTube Music (ytmusicapi) com autenticação via headers de sessão do navegador, mantendo tudo privado na sua máquina.

Instalação

$npx convez-ai AlexisLaporte/youtube-music-mcp-unofficial

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Encontrar e organizar músicas curtidas que não estão em nenhuma playlist (workflow 'unfiled_liked_songs')
  • Auditar e reorganizar suas playlists em lote com aprovação manual
  • Buscar e adicionar/remover tracks de forma automatizada e segura

Veredito

Solução prática para quem quer governança sobre sua biblioteca musical via Claude. Bem-arquitetada com guardrails (confirmação para ações destrutivas) e autenticação segura (headers locais). Risco baixo: usa API não-oficial, então mudanças no YouTube Music podem quebrar a ferramenta — recomendado acompanhar releases.

README

A tradução para o português deste README ainda está na fila.

ytmusic-manager

Claude Code plugin + MCP server for YouTube Music: talk to Claude (or any MCP client) to audit your liked songs, organize playlists, search, like/unlike — on your own account, from your own machine.

The killer workflow: unfiled_liked_songs finds every liked song that sits in no playlist, so your assistant can propose a filing plan and execute it in batches once you approve.

The plugin bundles the MCP server (auto-registered) and a ytmusic skill carrying the filing methodology (batching, duration checks for DJ sets, owned-playlists-only, guardrails).

How it works

  • Runs locally (stdio MCP server). Nothing is hosted; no account to create.
  • Uses ytmusicapi (YouTube Music's internal API — unofficial, no quota).
  • Auth = your own browser session headers, stored in ~/.config/ytmusic/browser.json (chmod 600). They never leave your machine and are never pasted into a conversation.

Install

1. Capture your session

uvx --from git+https://github.com/AlexisLaporte/youtube-music-mcp-unofficial ytmusic-manager setup

The wizard asks you to paste the request headers of a POST .../youtubei/v1/... request from music.youtube.com devtools (Network tab, logged in). It validates the session and prints the account name.

2. Install the plugin (Claude Code)

/plugin marketplace add AlexisLaporte/youtube-music-mcp-unofficial
/plugin install ytmusic-manager@ytmusic

This registers the MCP server and the ytmusic filing skill in one go.

Alternative: MCP server only

For Claude Desktop or any other MCP client:

claude mcp add ytmusic -- uvx --from git+https://github.com/AlexisLaporte/youtube-music-mcp-unofficial ytmusic-manager

or in any mcpServers config:

{
  "mcpServers": {
    "ytmusic": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/AlexisLaporte/youtube-music-mcp-unofficial", "ytmusic-manager"]
    }
  }
}

Tools

ToolEffect
whoamicheck the authenticated account
list_playlistsplaylists of your library
playlist_tracks / liked_songstracks of a playlist / your likes
searchsearch songs, albums, artists, playlists
unfiled_liked_songsliked songs missing from every playlist (+ stats)
create_playlist / edit_playlist / delete_playlistmanage playlists
add_tracks / remove_tracksfill playlists (batched)
like / unlikerate tracks

Destructive tools (delete_playlist, remove_tracks, unlike) are guarded: the server instructs the model to get your explicit confirmation first.

Caveats

  • Unofficial API: a YouTube change can break it; you use it under your own Google account and responsibility.
  • Browser-session auth lives ~2 years; if whoami fails, re-run setup.

License

MIT

Ver o original no GitHub

Bom para

Relacionados