Skip to main content
skill CX Codex

youtube-music — Claude Code skill: search and setup

Search YouTube Music by track or artist, then open a result in the default browser. It needs an API key and MCP configuration.

MIT ★ 138 updated 2026-09-03

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add happycapy-ai/Happycapy-skills --skill youtube-music -a claude-code
Open on GitHub

What youtube-music does

This skill connects Claude Code with YouTube Music through MCP. searchTrack looks up music by title or artist, while playTrack searches for a match and opens it in the user’s default browser.

A valid Google YouTube API Key is required. The MCP server runs through npx, so the package does not need a separate local install. The setup places the server configuration in .cursor/mcp.json or Claude Desktop settings, with the key supplied as YOUTUBE_API_KEY. Without that key, searches cannot run.

The skill can suggest revised terms or another artist when a track is missing. Playback is handed off to the browser rather than embedded in Claude Code.

What it helps with

  • find a song by title or artist
  • open a YouTube Music result in the browser
  • start music from a genre-based request
  • refine a search when a track is missing

Example prompts for the agent

  • Search YouTube Music for Bohemian Rhapsody by Queen.
  • Open some jazz music in the default browser.
  • Find tracks by Radiohead and play a suitable result.

How to install youtube-music

1Skills CLI (Vercel)

npx skills add happycapy-ai/Happycapy-skills --skill youtube-music -a claude-code

2Manually: put the files in place

~/.claude/skills/youtube-music/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/youtube-music/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about youtube-music

How do I install youtube-music in Claude Code?

Run npx skills add happycapy-ai/Happycapy-skills --skill youtube-music -a claude-code, then check ~/.claude/skills/youtube-music/SKILL.md.

What does youtube-music do?

It searches YouTube Music by track title or artist and can open a matching result in the default browser through MCP.

What does youtube-music need to run?

You need a valid Google YouTube API Key and an MCP server configuration. Put the key in the YOUTUBE_API_KEY environment setting.

Source text

SKILL.md · MIT
---
name: youtube-music
description: 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.
---

# 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)

© happycapy-ai · MIT · happycapy-ai/Happycapy-skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set41

The whole set →
oss-contributor-swarm oss-contributor-swarm deploys an autonomous 9-agent swarm to discover simple GitHub issues, write fixes, and submit pull requests. CX Codex +1 ★ 138repo stars llm-council llm-council is a Claude Code skill that sends one prompt to several AI models and displays their replies side by side, with shared-answer synthesis and anonymous voting. CX Codex +1 ★ 138repo stars capy-cortex capy-cortex keeps a local base of rules, anti-patterns and preferences, then feeds the matching ones into context through hooks. Useful when an agent keeps repeating the same mistakes. CX Codex +1 ★ 138repo stars happycapy-skill-creator happycapy-skill-creator adapts existing skills from anthropics/skills for HappyCapy environments. It strips Docker dependencies and bundles the result into a .skill archive. CX Codex +1 ★ 138repo stars agent-4-code-writer agent-4-code-writer — a Claude Code subagent that implements fixes or features within an open-source contributor swarm using an existing issue plan and codebase map. CX Codex ★ 138repo stars agent-3-codebase-explorer agent-3-codebase-explorer explores a repository before a fix or feature, locating relevant files and documenting the project structure for the next agents. CX Codex ★ 138repo stars agent-2-issue-analyst agent-2-issue-analyst is a Claude Code subagent that turns a chosen GitHub issue into a spec with complexity, files to touch and an ordered fix plan. CX Codex ★ 138repo stars agent-6-docs-writer agent-6-docs-writer is a Claude Code subagent that keeps README files, API docs, code comments, and CHANGELOG entries aligned with code updates in contributor swarms. CX Codex ★ 138repo stars

Project sponsors

Companies that keep this analytics open