About mcp-ytmusic
mcp-ytmusic is an MCP server published by gethyper in the Social category: enables users to search the YouTube Music catalog and manage playlists using natural language. It provides tools for searching songs, albums, and artists, as well as performing playlist operations like creating, adding, and deleting tracks.
Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/gethyper/mcp-ytmusicThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (3)
config`info`, `auth_status`
Parameters not published.
playlist`list`, `create`, `add`, `tracks`, `delete`
Parameters not published.
search—
Parameters not published.
Ask AI
Ask AI about mcp-ytmusic
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
mcp-ytmusic
YouTube Music MCP server for Claude Code. Search the catalog and manage playlists via natural language.
Tools
| Tool | Actions | Description |
|---|---|---|
search |
— | Search songs, videos, albums, artists, playlists |
playlist |
list, create, add, tracks, delete |
Manage playlists |
config |
info, auth_status |
Check configuration and auth |
Setup
# Clone and install
git clone https://github.com/alexcook/mcp-ytmusic.git
cd mcp-ytmusic
python3 -m venv venv
source venv/bin/activate
pip install -e .
# Initialize config directory
ytmusic-mcp init
# Authenticate (paste browser headers from Chrome DevTools on music.youtube.com)
ytmusic-mcp auth
# Verify
ytmusic-mcp status
Claude Code Integration
Add to ~/.claude/mcp.json:
{
"mcpServers": {
"YouTube Music": {
"command": "/path/to/mcp-ytmusic/venv/bin/python",
"args": ["-m", "ytmusic_mcp"]
}
}
}
Auth
Uses browser cookie authentication via ytmusicapi. One-time setup:
- Open Chrome → https://music.youtube.com (make sure you're logged in)
- Open DevTools (F12) → Network tab
- Click any request to music.youtube.com
- Right-click → Copy → Copy request headers
- Run
ytmusic-mcp authand paste when prompted
Credentials are saved to ~/.config/ytmusic-mcp/browser.json and are valid for ~2 years.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.