Infrastructure You Can Trust for Agentic Products
© 2026 MewCP. All rights reserved.
YouTube
Share your feedback directly with the maintainers - every feedback helps make this server better for everyone.
Your YouTube, fully accessible through AI.
A Model Context Protocol (MCP) server that exposes YouTube's API for searching videos, managing playlists, reading channel data, posting comments, and more.
Overview
The MewCP YouTube MCP Server provides authenticated access to the YouTube Data API v3:
Search and retrieve videos, channel data, and comments
Manage playlists: create, browse, and add videos
Interact with content: rate videos, post comments, subscribe to channels
Perfect for:
Building AI assistants that can search and analyze YouTube content
Automating YouTube channel management tasks
Integrating YouTube data into workflows and dashboards
get_my_channel — Get the authenticated user's YouTube channel infoGet information about the authenticated user's YouTube channel. Returns snippet, contentDetails, and statistics for the channel.
Inputs:
output data
{ kind : string | null ; etag : string | null ; nextPageToken : string | null ; prevPageToken : string | null ; items : object[] | null ; pageInfo : object | null ; } get_my_playlists — Get playlists from the authenticated user's channelGet playlists from the authenticated user's channel. Returns snippet and contentDetails for each playlist.
Inputs:
- `max_results` (int, optional, default: 25 ) — Maximum playlists to return (capped at 50 ). Defaults to 25 . output data
{ kind : string | null ; etag : string | null get_my_subscriptions — Get the authenticated user's channel subscriptionsGet the authenticated user's channel subscriptions. Returns snippet and contentDetails for each subscription.
Inputs:
- `max_results` (int, optional, default: 25 ) — Maximum subscriptions to return (capped at 50 ). Defaults to 25 . output data
{ kind : string | null ; etag : string | null get_my_activities — Get recent activities on the authenticated user's channelGet recent activities on the authenticated user's channel. Returns snippet and contentDetails for each activity.
Inputs:
- `max_results` (int, optional, default: 25 ) — Maximum activities to return (capped at 50 ). Defaults to 25 . output data
{ kind : string | null ; etag : string | subscribe_to_channel — Subscribe to a YouTube channelSubscribe to a YouTube channel. Returns the created subscription resource including snippet details.
Inputs:
- `channel_id` (str, required) — Channel ID to subscribe to. Required. output data
{ kind : string | null ; etag : string | null ; id : string | null ; search_videos — Search for videos on YouTubeSearch for videos on YouTube.
Inputs:
- `query` (str, required) — Search query text. Required. - `max_results` (int, optional, default: 10 ) — Maximum videos to return (capped at 50 ). Defaults to 10 . - `order` (str, optional, default: "relevance" ) — Sort order. Common values: `relevance`, `date`, `rating`, `title`, `videoCount`, `viewCount`. Defaults to `relevance`. output data
get_video_details — Get detailed information about a specific videoGet detailed information about a specific video by ID.
Inputs:
- `video_id` (str, required) — YouTube video ID. Required. output data
{ kind : string | null ; etag : string | null ; nextPageToken : string | null ; prevPageToken get_channel_videos — Get videos from a specific channelGet videos from a specific channel.
Inputs:
- `channel_id` (str, required) — YouTube channel ID. Required. - `max_results` (int, optional, default: 25 ) — Maximum videos to return (capped at 50 ). Defaults to 25 . output data
{ kind : string | null ; etag : string get_video_comments — Get comments for a specific videoGet comments for a specific video.
Inputs:
- `video_id` (str, required) — YouTube video ID. Required. - `max_results` (int, optional, default: 20 ) — Maximum comments to return (capped at 100 ). Defaults to 20 . - `order` (str, optional, default: "relevance" ) — Comment order. Supported values: `relevance`, `time`. Defaults to `relevance`. output data
post_comment — Post a comment on a videoPost a comment on a video.
Inputs:
- `video_id` (str, required) — YouTube video ID. Required. - `text` (str, required) — Comment text content. Required. output data
{ kind : string | null ; etag : string | null ; id : string | null rate_video — Rate a video (like or dislike)Rate a video (like or dislike).
Inputs:
- `video_id` (str, required) — YouTube video ID. Required. - `rating` ( "like" | "dislike" | "none" , required) — Rating value: `like`, `dislike`, or `none` (removes rating). Required. output data
get_video_transcript — Fetch the transcript (captions) for a YouTube videoFetch the transcript (captions) for a YouTube video as plain text and individual timed segments. Uses auto-generated or manually created captions. Specify preferred languages in priority order; falls back to the first available if none match.
Inputs:
- `video_id` (str, required) — YouTube video ID. Required. - `languages` (list[ str ], optional, default: null ) — Preferred language codes in priority order (e.g. [ 'en' , 'fr' ]). Omit to use the video's default language. output data
list_video_transcripts — List all available transcript tracks for a YouTube videoList all available transcript tracks for a YouTube video, including language, language code, whether the track is auto-generated, and whether it can be translated. Use this before get_video_transcript to discover available languages.
Inputs:
- `video_id` (str, required) — YouTube video ID. Required. output data
{ video_id : string; tracks : { language : string; language_code : string; is_generated : boolean; is_translatable get_playlist_items — Get videos from a specific playlistGet videos from a specific playlist.
Inputs:
- `playlist_id` (str, required) — YouTube playlist ID. Required. - `max_results` (int, optional, default: 50 ) — Maximum items to return (capped at 50 ). Defaults to 50 . output data
{ kind : string | null ; etag : string create_playlist — Create a new playlist on the authenticated user's channelCreate a new playlist on the authenticated user's channel.
Inputs:
- `title` (str, required) — Playlist title. Required. - `description` (str, optional, default: "" ) — Optional playlist description. Defaults to empty string. - `privacy_status` (str, optional, default: "private" ) — Privacy setting. Common values: `private`, `public`, `unlisted`. Defaults to `private`. output data
add_video_to_playlist — Add a video to a playlistAdd a video to a playlist.
Inputs:
- `playlist_id` (str, required) — Target playlist ID. Required. - `video_id` (str, required) — Video ID to insert. Required. output data
{ kind : string | null ; etag : string | null ; id : string | null API Parameters Reference
Response Envelope Every tool returns the same top-level envelope. Only data
// Success { "success" : true , "statusCode" : 200 , "retriable" : false , "retry_after_seconds" : null , "error" : null , "data" : { ... } }
// Error Common Parameters
max_results order Resource Formats Video ID:
11 -character alphanumeric string Example: dQw 4 w 9 WgXcQ channel ID:
starts with "UC" followed by 22 characters Example: UCq-Fj 5 jknLsUf-MWSy 4 _brA playlist ID:
Troubleshooting
Missing or Invalid Headers
Cause: OAuth token not provided in request headers or incorrect formatSolution:
Verify Authorization: Bearer YOUR_OAUTH_TOKEN X-Mewcp-Credential-Id: CREDENTIAL-ID
Check that your OAuth credential is active in your MewCP account
Insufficient Credits
Cause: API calls have exceeded your request limitsSolution:
Check credit usage in your Curious Layer dashboard
Upgrade to a paid plan or add credits for higher limits
Contact support for credit adjustments
Credential Not Connected
Cause: No YouTube credential linked to your accountSolution:
Go to Credentials in your MewCP dashboard
Connect your Google/YouTube account via OAuth
Retry the request with the correct X-Mewcp-Credential-Id
Malformed Request Payload
Cause: JSON payload is invalid or missing required fieldsSolution:
Validate JSON syntax before sending
Ensure all required tool parameters are included
Check parameter types match expected values
Server Not Found
Cause: Incorrect server name in the API endpointSolution:
Verify endpoint format: { server-name }/mcp/{ tool-name }
Use correct server name from documentation
Check available servers in your Curious Layer account
YouTube API Error
Cause: Upstream YouTube Data API returned an errorSolution:
Check YouTube service status at Google Workspace Status
Verify your OAuth credential has the required YouTube scopes
Review the error message for specific details
;
nextPageToken : string | null ;
prevPageToken : string | null ;
items : object[] | null ;
pageInfo : object | null ;
}
;
nextPageToken : string | null ;
prevPageToken : string | null ;
items : object[] | null ;
pageInfo : object | null ;
}
null
;
nextPageToken : string | null ;
prevPageToken : string | null ;
items : object[] | null ;
pageInfo : object | null ;
}
snippet
: object
|
null
;
contentDetails : object | null ;
statistics : object | null ;
status : object | null ;
}
kind : string | null ;
etag : string | null ;
nextPageToken : string | null ;
prevPageToken : string | null ;
items : object[] | null ;
pageInfo : object | null ;
}
: string
|
null
;
items : object[] | null ;
pageInfo : object | null ;
}
|
null
;
nextPageToken : string | null ;
prevPageToken : string | null ;
items : object[] | null ;
pageInfo : object | null ;
}
: string
|
null
;
etag : string | null ;
nextPageToken : string | null ;
prevPageToken : string | null ;
items : object[] | null ;
pageInfo : object | null ;
}
;
snippet : object | null ;
contentDetails : object | null ;
statistics : object | null ;
status : object | null ;
}
{
video_id : string;
language : string;
is_generated : boolean;
segments : {
text : string;
start : number;
duration : number;
}[];
full_text : string;
}
: boolean;
}[];
}
|
null
;
nextPageToken : string | null ;
prevPageToken : string | null ;
items : object[] | null ;
pageInfo : object | null ;
}
null
;
etag : string | null ;
id : string | null ;
snippet : object | null ;
contentDetails : object | null ;
statistics : object | null ;
status : object | null ;
}
;
snippet : object | null ;
contentDetails : object | null ;
statistics : object | null ;
status : object | null ;
}
{
"success" : false ,
"statusCode" : 400 ,
"retriable" : false ,
"retry_after_seconds" : null ,
"error" : { "code" : "ERROR_CODE" , "message" : "description" , "details" : {} },
"data" : null
}
retriable true false retry_after_seconds retriable true error.code VALIDATION_ERROR AUTH_ERROR UPSTREAM_ERROR SERVER_ERROR starts with "PL" followed by alphanumeric characters Example: PLbpi 6 ZahtOH 6 Ar_ 3 GPy 3 workbp 73 xONIf
