youtube-mcp

YouTube CLI and MCP tool for humans and AI agents. Upload videos, manage comments, search, view analytics, and more — from your terminal or via any MCP-compatible AI agent.

The CLI command is just yt — short and sweet.

brew install virat-mankali/tap/youtube-mcp

1. Go to console.cloud.google.com
2. Create a project and enable YouTube Data API v3
3. Create an OAuth 2.0 Client ID (Desktop App type)
4. Copy your Client ID and Client Secret, then run:

yt auth login --client-id YOUR_ID --client-secret YOUR_SECRET

# Auth
yt auth login
yt auth login --manual        # SSH/headless environments
yt auth logout
yt auth status

# Videos
yt videos list
yt videos get <videoId>
yt videos upload ./video.mp4 --title "My Video" --privacy public
yt videos update <videoId> --title "New Title"
yt videos delete <videoId> --yes

# Comments
yt comments list <videoId>
yt comments reply <commentId> "Thanks!"
yt comments post <videoId> "Great video!"
yt comments delete <commentId>

# Search
yt search "typescript tutorials"
yt search "react hooks" --order viewCount --max-results 5

# Analytics
yt analytics channel
yt analytics video <videoId>

# Playlists
yt playlists list
yt playlists create "My Playlist"
yt playlists add <playlistId> <videoId>

# MCP Server
yt serve

Add to your MCP client config (e.g. Claude Desktop, Kiro, Cursor):

{
  "mcpServers": {
    "youtube": {
      "command": "yt",
      "args": ["serve"]
    }
  }
}

Or pass credentials via env vars for headless setups:

{
  "mcpServers": {
    "youtube": {
      "command": "yt",
      "args": ["serve"],
      "env": {
        "YOUTUBE_CLIENT_ID": "your_client_id",
        "YOUTUBE_CLIENT_SECRET": "your_client_secret",
        "YOUTUBE_ACCESS_TOKEN": "ya29.xxx",
        "YOUTUBE_REFRESH_TOKEN": "1//xxx"
      }
    }
  }
}

| Varia