youtube-music
Search and play music tracks on YouTube Music through MCP integration. Use when user wants to search for songs, play music, or discover tracks on YouTube Music platform.
Best use case
youtube-music is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Search and play music tracks on YouTube Music through MCP integration. Use when user wants to search for songs, play music, or discover tracks on YouTube Music platform.
Teams using youtube-music should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/youtube-music/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How youtube-music Compares
| Feature / Agent | youtube-music | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Search and play music tracks on YouTube Music through MCP integration. Use when user wants to search for songs, play music, or discover tracks on YouTube Music platform.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# YouTube Music MCP
🎵 A Model Context Protocol (MCP) server that enables AI assistants to search for and play tracks on YouTube Music.
## Overview
This skill provides integration with YouTube Music through the MCP protocol, allowing you to search for songs by title or artist name and play them directly in the user's default web browser.
## Available Tools
- **searchTrack** - Search for music tracks on YouTube Music by title or artist name
- **playTrack** - Search and automatically open tracks in the default web browser
## Prerequisites
Before using this skill, ensure you have:
1. A valid **Google YouTube API Key** from the [Google Cloud Console](https://console.cloud.google.com/marketplace/product/google/youtube.googleapis.com)
2. Cursor or Claude Desktop properly configured
## Installation
Add the following configuration to your `.cursor/mcp.json` file (or Claude Desktop configuration):
```json
{
"mcpServers": {
"youtube-music-mcp": {
"command": "npx",
"args": ["-y", "@instructa/mcp-youtube-music"],
"env": {
"YOUTUBE_API_KEY": "<YOUR_API_KEY>"
}
}
}
}
```
Replace `<YOUR_API_KEY>` with your actual YouTube API key.
## Usage Examples
### Searching for Tracks
```
User: "Search for Bohemian Rhapsody by Queen"
Assistant: [Uses searchTrack tool to find the track on YouTube Music]
```
### Playing Tracks
```
User: "Play some jazz music"
Assistant: [Uses playTrack tool to search and open jazz music in browser]
```
## Guidelines
- Always verify that the YouTube API key is configured before attempting to use the tools
- Provide clear feedback to users about what tracks were found or played
- If a track cannot be found, suggest alternative search terms or artists
- The playTrack tool will open tracks in the user's default web browser
- Respect user preferences for music genres and artists
## Technical Details
- **Protocol**: Model Context Protocol (MCP)
- **Platform**: YouTube Music
- **Execution**: Runs via `npx` without requiring local installation
- **License**: MIT
## Author
Created by Kevin Kern / Instructa ([@kregenrek](https://x.com/kregenrek))
## Resources
- GitHub Repository: [instructa/mcp-youtube-music](https://github.com/instructa/mcp-youtube-music)
- Learn more: [instructa.ai](https://www.instructa.ai)Related Skills
skywork-music-maker
Create professional music with Mureka AI API — songs, instrumentals, and lyrics from natural language descriptions in any language. Use when users want to generate a song, create a beat or instrumental, write lyrics, clone vocals, upload reference tracks, or do anything related to AI music creation, even casual requests like "make me a chill lo-fi beat".
youtube-summarizer
Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks
youtube-automation
Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.
elevenlabs-music
ElevenLabs AI music generation - create original music from text prompts via inference.sh CLI. Capabilities: text-to-music, custom duration up to 10 minutes, genre/mood/instrument control, royalty-free commercial use. Use for: background music, soundtracks, jingles, podcasts, video scores, game audio. Triggers: elevenlabs music, eleven labs music, ai music, generate music, music generation, compose music, ai composer, create song, soundtrack, background music, jingle, elevenlabs compose, music ai
youtube-downloader
Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.
music-generation
Tools, patterns, and utilities for generating professional music with realistic instrument sounds. Write custom compositions using music21 or learn from existing MIDI files.
code-to-music
Tools, patterns, and utilities for creating music with code. Output as a .mp3 file with realistic instrument sounds. Write custom compositions to bring creativity to life through music. This skill should be used whenever the user asks for music to be created. Never use this skill for replicating songs, beats, riffs, or other sensitive works. The skill is not suitable for vocal/lyrical music, audio mixing/mastering (reverb, EQ, compression), real-time MIDI playback, or professional studio recording quality.
YouTube Video Transcription
Transcribe YouTube videos to text using OpenAI Whisper and yt-dlp.
YouTube Marketing
## Overview
ai-music-generation
Generate AI music and songs with Diffrythm, Tencent Song Generation via inference.sh CLI. Models: Diffrythm (fast song generation), Tencent Song Generation (full songs with vocals). Capabilities: text-to-music, song generation, instrumental, lyrics to song, soundtrack creation. Use for: background music, social media content, game soundtracks, podcasts, royalty-free music. Triggers: music generation, ai music, generate song, ai composer, text to music, song generator, create music with ai, suno alternative, udio alternative, ai song, ai soundtrack, generate soundtrack, ai jingle, music ai, beat generator
axiom-now-playing-musickit
MusicKit Now Playing integration patterns. Use when playing Apple Music content with ApplicationMusicPlayer and understanding automatic vs manual Now Playing info updates.
Daily Logs
Record the user's daily activities, progress, decisions, and learnings in a structured, chronological format.