YouTube播放列表管理MCP服务器

youtube-mcp

An MCP (Model Context Protocol) server for YouTube playlist management. Lets you create, delete, and reorganize YouTube playlists directly through Claude.

Features

• List all playlists on your YouTube account
• Create and delete playlists
• Add and remove videos from playlists
• Move videos between playlists
• List all channels on an account
• Search for music videos
• Get detailed video metadata

Setup

Prerequisites

• Node.js 18 or later
• A Google Cloud project with the YouTube Data API v3 enabled
• A YouTube API key (for read-only operations)
• Google OAuth 2.0 credentials — Client ID and Client Secret — for write operations (create/delete playlists, manage videos)

Installation

git clone https://github.com/MetalOath/youtube-mcp.git
cd youtube-mcp
npm install
npm run build

Configuration in Claude Code

Add the server to your .claude.json configuration:

{
  "mcpServers": {
    "youtube": {
      "command": "node",
      "args": ["/absolute/path/to/youtube-mcp/build/index.js"],
      "env": {
        "YOUTUBE_API_KEY": "your_api_key_here",
        "YOUTUBE_CLIENT_ID": "your_client_id_here",
        "YOUTUBE_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

Replace the path and credential values with your own. Restart Claude Code after saving the config.

Authentication

This server uses two levels of access:

API key — required for all read-only operations (searching videos, listing public playlists, etc.). Set via YOUTUBE_API_KEY.

OAuth 2.0 — required for write operations (creating/deleting playlists, managing playlist contents). Set via YOUTUBE_CLIENT_ID and YOUTUBE_CLIENT_SECRET.

To set up OAuth credentials:

1. Go to Google Cloud Console and open your project.
2. Enable the YouTube Data API v3.
3. Under Credentials, create an OAuth 2.0 Client ID with application type "Desktop App".
4. Copy the Client ID and Client Secret into your config.

To complete the OAuth flow at runtime:

1. Call authenticate_youtube with getAuthUrl: true to get an authorization URL.
2. Open the URL in your browser and grant access to your Google account.
3. Copy the authorization code from the redirect URL.
4. Call authenticate_youtube again with the authCode to complete authentication.

OAuth tokens are persisted to ~/.youtube-mcp-tokens.json after a successful authentication. On subsequent server starts, the saved tokens are loaded automatically — you only need to authenticate once. If the tokens expire or are revoked, repeat the OAuth flow above to refresh them.

Available Tools

License

MIT