YouTube

HTTPv1.0.0Credential RequiredJan 22, 2026

Documentation

Guide

Manage YouTube channels, videos, playlists, and analytics via API.

A Model Context Protocol (MCP) server that exposes YouTube's API for managing channels, uploading content, interacting with videos, and accessing comprehensive analytics.

Overview

The YouTube MCP Server provides stateless, multi-user access to YouTube's core operations:

Channel Management — Access and manage authenticated user's YouTube channel, subscriptions, and activities
Video Operations — Search, retrieve, rate, and comment on videos with detailed metadata
Playlist Management — Create playlists, manage playlist items, and organize video collections
Content Interaction — Subscribe to channels, like/dislike videos, and post comments

Perfect for:

Automated YouTube content management and distribution
Building AI-powered video discovery and recommendation systems
Integrating YouTube capabilities into multi-agent applications and workflows

Tools

Retrieve detailed information about the authenticated user's YouTube channel including channel ID, name, subscriber count, and other metadata.

Inputs:

oauth_token (object, required) — Valid Google OAuth token object with YouTube scopes

Output:

{
  "result": {
    "kind": "youtube#channelListResponse",
    "pageInfo": {
      "totalResults": 1,
      "resultsPerPage": 1
    },
    "items": [
      {
        "id": "UCxxxxxxxxxxxxxx",
        "snippet": {
          "title": "Channel Name",
          "description": "Channel description"
        }
      }
    ]
  }

Usage Example:

POST /mcp/cyoutube/get_my_channel
 
{
  "oauth_token": {
    "token": "ya29.a0AfH6SMxxxxxxxxxxxxxx",
    "refresh_token": "1//0xxxxx",
    "token_uri": "https://oauth2.googleapis.com/token",
    "client_id": "xxx.apps.googleusercontent.com",
    "client_secret": "xxxxx",
    "scopes": ["https://www.googleapis.com/auth/youtube"]
  }
}

Retrieve all playlists created by the authenticated user with pagination support.

Inputs:

oauth_token (object, required) — Valid Google OAuth token object
max_results (integer, optional) — Maximum playlists to return (default: 25)

Output:

{
  "result": {
    "kind": "youtube#playlistListResponse",
    "pageInfo": {
      "totalResults": 5,
      "resultsPerPage": 25
    },
    "items": [
      {

Search for videos on YouTube using keywords with advanced filtering options.

Inputs:

oauth_token (object, required) — Valid Google OAuth token object
query (string, required) — Search query string
max_results (integer, optional) — Maximum results to return (default: 10)
order (string, optional) — Sort order: "relevance", "date", "viewCount", "rating" (default: "relevance")

Output:

{
  "result": {
    "kind": "youtube#searchListResponse",
    "pageInfo": {
      "totalResults": 1000000,

Retrieve comprehensive details about a specific video including statistics, ratings, comments count, and metadata.

Inputs:

oauth_token (object, required) — Valid Google OAuth token object
video_id (string, required) — The YouTube video ID

Output:

{
  "result": {
    "kind": "youtube#videoListResponse",
    "pageInfo": {
      "totalResults": 1,
      "resultsPerPage": 1
    },
    "items": [

Retrieve all videos uploaded by a specific channel with pagination support.

Inputs:

oauth_token (object, required) — Valid Google OAuth token object
channel_id (string, required) — The YouTube channel ID
max_results (integer, optional) — Maximum videos to return (default: 25)

Output:

{
  "result": {
    "kind": "youtube#searchListResponse",
    "pageInfo": {
      "totalResults": 100,
      "resultsPerPage": 25
    },

Retrieve all videos in a specific playlist with full details and ordering.

Inputs:

oauth_token (object, required) — Valid Google OAuth token object
playlist_id (string, required) — The YouTube playlist ID
max_results (integer, optional) — Maximum items to return (default: 50)

Output:

{
  "result": {
    "kind": "youtube#playlistItemListResponse",
    "pageInfo": {
      "totalResults": 50,
      "resultsPerPage": 50
    },

Retrieve comments on a video with filtering and sorting options.

Inputs:

oauth_token (object, required) — Valid Google OAuth token object
video_id (string, required) — The YouTube video ID
max_results (integer, optional) — Maximum comments to return (default: 20)
order (string, optional) — Sort order: "relevance" or "time" (default: "relevance")

Output:

{
  "result": {
    "kind": "youtube#commentThreadListResponse",
    "pageInfo": {
      "totalResults": 5000,

Retrieve all channels that the authenticated user is subscribed to.

Inputs:

oauth_token (object, required) — Valid Google OAuth token object
max_results (integer, optional) — Maximum subscriptions to return (default: 25)

Output:

{
  "result": {
    "kind": "youtube#subscriptionListResponse",
    "pageInfo": {
      "totalResults": 150,
      "resultsPerPage": 25
    },
    "items": [

Retrieve recent activities on the authenticated user's channel including uploads, likes, and other interactions.

Inputs:

oauth_token (object, required) — Valid Google OAuth token object
max_results (integer, optional) — Maximum activities to return (default: 25)

Output:

{
  "result": {
    "kind": "youtube#activityListResponse",
    "pageInfo": {
      "totalResults": 100,
      "resultsPerPage": 25
    },
    "items": [

Create a new playlist with customizable title, description, and privacy settings.

Inputs:

oauth_token (object, required) — Valid Google OAuth token object
title (string, required) — Playlist title
description (string, optional) — Playlist description (default: "")
privacy_status (string, optional) — Privacy level: "private", "public", or "unlisted" (default: "private")

Output:

{
  "result": {
    "kind": "youtube#playlist",
    "id": "PLxxxxxxxxxxxxxx",
    "snippet"

Add a specific video to an existing playlist.

Inputs:

oauth_token (object, required) — Valid Google OAuth token object
playlist_id (string, required) — The target playlist ID
video_id (string, required) — The video ID to add

Output:

{
  "result": {
    "kind": "youtube#playlistItem",
    "id": "PLitem456",
    "snippet": {
      "playlistId": "PLxxxxxxxxxxxxxx",
      "videoId"

Subscribe the authenticated user to a specific YouTube channel.

Inputs:

oauth_token (object, required) — Valid Google OAuth token object
channel_id (string, required) — The channel ID to subscribe to

Output:

{
  "result": {
    "kind": "youtube#subscription",
    "id": "subscription-123",
    "snippet": {
      "title": "Channel Name",
      "channelId": "UCxxxxxxxxxxxxxx"
    }

Like, dislike, or clear rating for a video.

Inputs:

oauth_token (object, required) — Valid Google OAuth token object
video_id (string, required) — The video ID to rate
rating (string, required) — Rating action: "like", "dislike", or "none"

Output:

{
  "result": {
    "message": "Video rated successfully"
  }
}

Usage Example:

Post a comment on a specific video as the authenticated user.

Inputs:

oauth_token (object, required) — Valid Google OAuth token object
video_id (string, required) — The video ID to comment on
text (string, required) — Comment text content

Output:

{
  "result": {
    "kind": "youtube#comment",
    "id": "comment-123",
    "snippet": {
      "videoId": "dQw4w9WgXcQ",
      "textDisplay"

Reference & Support

Pagination

max_results — Maximum results per page (varies by endpoint: 10-50)
nextPageToken — Token for retrieving next page of results
prevPageToken — Token for retrieving previous page of results

Search & Filtering

query — Search keywords for video search
order — Sort results by: "relevance", "date", "viewCount", "rating"

Content Types

kind — Response type identifier (e.g., "youtube#video", "youtube#playlist")
type — Activity type: "upload", "like", "subscribe", "favorite", "comment", "playlistItem"

Resource Formats

Video Resource:

All tools require a valid Google OAuth token. Here's how to obtain one:

Step 1: Create Google Cloud Project

Go to Google Cloud Console
Create a new project or select an existing one
Enable the YouTube Data API v3 from the API Library

Step 2: Create OAuth 2.0 Credentials

Navigate to Credentials in Google Cloud Console
Click + Create Credentials → OAuth client ID
Select your application type (Desktop, Web, or other)
Download the credentials JSON file

Step 3: Authenticate

Use your Google account to authenticate and obtain the OAuth token. Refer to Google OAuth 2.0 Documentation for detailed authentication steps.

Step 4: Required Scopes

Ensure your OAuth token has these scopes:

https://www.googleapis.com/auth/youtube — Full YouTube account access
https://www.googleapis.com/auth/youtube.readonly — Read-only access to YouTube
https://www.googleapis.com/auth/youtube.force-ssl — HTTPS-only access

Missing or Invalid OAuth Token

Cause: OAuth token not provided in request or incorrect format
Solution:
1. Verify oauth_token parameter is present in request
2. Check token is valid and not expired
3. Obtain a fresh OAuth token from Google

Insufficient Permissions

Cause: OAuth token lacks required scopes for operation
Solution:
1. Verify token has all required YouTube scopes
2. Regenerate token with additional scopes if needed
3. Check Google Cloud project has YouTube Data API v3 enabled

Insufficient Credits

Cause: API calls have exceeded your requests limits
Solution:
1. Check credit usage in your Curious Layer dashboard
2. Upgrade to a paid plan or add credits for higher limits
3. Contact support for credit adjustments

Malformed Request Payload

Cause: JSON payload is invalid or missing required fields
Solution:
1. Validate JSON syntax before sending
2. Ensure all required parameters are included
3. Check parameter types match expected values (string, integer, object)

Connect

Get connection URL

https://gateway.mewcp.com/youtube/mcp

Request Builder

import asyncio
from fastmcp import Client

# Real MewCP gateway URL for this server
GATEWAY_URL = "https://gateway.mewcp.com/youtube/mcp"
API_KEY = "YOUR_API_KEY"

headers={
    "Authorization": f"Bearer {API_KEY}"
}

async def main():
    
    client = Client(GATEWAY_URL, headers=headers)
    
    async with client:
        # Test the connection by pinging the server
        await client.ping()
        
        # List available operations
        tools = await client.list_tools()
        resources = await client.list_resources()
        prompts = await client.list_prompts()

        # Execute operations
        result = await client.call_tool("example_tool", {"param": "value"})
        print(result)

asyncio.run(main())

YouTube

Documentation

Overview

Tools

Reference & Support

Search & Filtering

Content Types

Resource Formats

Step 1: Create Google Cloud Project

Step 2: Create OAuth 2.0 Credentials

Step 3: Authenticate

Step 4: Required Scopes

Missing or Invalid OAuth Token

Insufficient Permissions

Insufficient Credits

Malformed Request Payload

Overview

Tools

Reference & Support

Search & Filtering

Content Types

Resource Formats

Step 1: Create Google Cloud Project

Step 2: Create OAuth 2.0 Credentials

Step 3: Authenticate

Step 4: Required Scopes

Missing or Invalid OAuth Token

Insufficient Permissions

Insufficient Credits

Malformed Request Payload

Server Not Found

Video Not Found or Access Denied

Authentication Token Invalid or Expired

Quota Exceeded