Skip to main content
Glama
moyohussein

YouTube MCP Server

by moyohussein

YouTube MCP Server

A Model Context Protocol (MCP) server for YouTube, running on Cloudflare Workers using the Agents SDK (McpAgent). Enables AI language models to interact with YouTube content through 18 MCP tools.

Deployment

# Install dependencies
npm install

# Set secrets
npx wrangler secret put YOUTUBE_API_KEY
npx wrangler secret put GOOGLE_OAUTH_CLIENT_ID    # Required for transcripts
npx wrangler secret put GOOGLE_OAUTH_CLIENT_SECRET # Required for transcripts

# Deploy
npx wrangler deploy

# MCP endpoint: https://youtube-mcp-server.<your-subdomain>.workers.dev/mcp

Related MCP server: YouTube MCP Server

Development

# Local dev with auto-reload
npm run dev

# Typecheck
npm run typecheck

Create a .env file for local development (see .env.example), then:

npx wrangler dev --port 8787

Available Tools (18)

Video

Tool

Description

videos_getVideo

Get detailed video information

videos_searchVideos

Search videos with channel-level filtering

videos_getVideoStats

Get view count, likes, comments statistics

videos_getTrendingVideos

Get trending videos by region

videos_getRelatedVideos

Find related videos ("Up Next" suggestions)

Transcript

Tool

Description

transcripts_getTranscript

Retrieve video captions (requires Google OAuth)

transcripts_searchTranscript

Search within a video transcript

transcripts_getTimestampedTranscript

Get transcript with human-readable timestamps

Channel

Tool

Description

channels_getChannel

Get channel information with enrichment

channels_getChannels

Bulk channel lookup

channels_searchChannels

Search channels with subscriber/creator filtering

channels_findCreators

Discover creators matching a topic

channels_listVideos

List recent videos from a channel

channels_getStatistics

Get channel subscriber/video/view counts

channels_getPlaylists

Get all playlists by a channel

Playlist

Tool

Description

playlists_getPlaylist

Get playlist details

playlists_getPlaylistItems

List videos in a playlist

playlists_searchPlaylists

Search for public playlists

Authentication

  • 15 tools (video, channel, playlist) use only the YouTube Data API key

  • 3 transcript tools require Google OAuth 2.0 (YouTube Captions API requires it)

To enable transcripts:

  1. Create OAuth 2.0 credentials in Google Cloud Console

  2. Add redirect URI: https://your-worker.workers.dev/auth/google/callback

  3. Set secrets and deploy

  4. Visit /auth/google on your worker to authorize

Architecture

Built on Cloudflare Workers using:

  • agents (McpAgent) — Durable Object-backed MCP server

  • @modelcontextprotocol/sdk — MCP protocol implementation

  • zod — Input validation for all tool schemas

  • KV — Response caching (1h search, 24h details)

No googleapis, youtube-transcript, or ytdl-core — all YouTube API calls use native fetch().

F
license - not found
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/moyohussein/youtube-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server