YouTube MCP

YouTube MCP

Create playlists from song lists with OAuth2. Search videos, manage playlists, let AI curate your YouTube collections.

2
Stars
1
Forks
0
Releases

Overview

An MCP server that exposes YouTube Data API v3 capabilities through the Model Context Protocol, enabling clients to search videos, create and manage playlists, add videos to playlists, and list or delete user playlists. It integrates with Claude Desktop and other MCP clients, allowing hands-off control of YouTube content from any MCP-enabled interface. The server requires Node.js 18+, YouTube Data API v3 access, and a Google Cloud Console project, with OAuth 2.0 credentials (Client ID, Client Secret) and an optional API key for read-only scenarios. Setup includes running an OAuth setup wizard to obtain a refresh token and generating a .env file containing credentials. Configuration for Claude Desktop involves mapping environment variables to the YouTube credentials. Usage examples include commands to search videos, create a playlist, or list playlists. Troubleshooting and security notes cover common OAuth and quota issues, keeping refresh tokens secure, and best practices like not committing .env. The project acknowledges MCP SDK and Google APIs Node.js Client.

Details

Owner
aardeshir
Language
JavaScript
License
MIT License
Updated
2025-12-07

Features

Search YouTube videos

Query YouTube for videos and return results through MCP.

Create and manage playlists

Create new playlists and modify existing ones for the user.

Add videos to playlists

Add selected videos to existing or new playlists.

List user playlists

Retrieve and display a user's YouTube playlists.

Delete playlists

Delete a specified playlist from the user's account.

Audience

Content CreatorsUse MCP to search YouTube, manage playlists, and curate videos via Claude Desktop or MCP clients.
MCP DevelopersDevelopers integrating YouTube capabilities into MCP workflows and client applications.

Tags

YouTubeMCPYouTube Data API v3OAuth 2.0PlaylistsVideo searchClaude DesktopMCP serverAPI keyGoogle Cloud Console