mcp-youtube-search
Searches YouTube videos via SerpAPI, returning title, link, channel, views, duration, and published date.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-youtube-search search for python tutorials"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP YouTube Search
An MCP server that searches YouTube through SerpApi, for Claude, Cursor and other MCP clients: titles, links, channels, views, publish dates, durations and descriptions.
Requirements
Python 3.10 or later (or uv)
A SerpApi key in
SERP_API_KEY(serpapi.com has a free tier)
Related MCP server: YouTube MCP Server
Use it from an MCP client
{
"mcpServers": {
"youtube-search": {
"command": "uvx",
"args": ["mcp-youtube-search", "server"],
"env": { "SERP_API_KEY": "your-serpapi-key" }
}
}
}Or pip install mcp-youtube-search and use "command": "mcp-youtube-search", "args": ["server"].
Command line
export SERP_API_KEY="your-serpapi-key"
mcp-youtube-search search "model context protocol" --max-results 5
mcp-youtube-search server # MCP over stdio
mcp-youtube-search server --connection_type http --port 3002 # Streamable HTTP at http://127.0.0.1:3002/mcpLOG_LEVEL=DEBUG shows more detail on stderr. The API key is never logged.
Tool
Tool | What it does |
| Videos for a query. |
Development
uv sync
uv run pytest
uv run ruff check .License
MIT
Available Tools
1 toolsearch_youtubeSearch YouTubeARead-only
Search YouTube for videos: title, link, channel, views, publish date, duration and description.
Inputs: query (required), country, language, max_results. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only a single tool, there is no possibility of overlap or misselection between tools. The one tool's purpose (YouTube video search) is unambiguous.
The lone tool uses a clean verb_noun snake_case pattern (search_youtube). There is no inconsistent convention to conflict with it.
A single tool is thin even for a search-focused server; it covers exactly one query type. It earns its place but leaves the surface feeling minimal.
Search alone leaves notable gaps: no tool to fetch a specific video's full details, channel info, comments, or transcripts. Core search is covered but agents will hit dead ends for follow-up queries.
Maintenance
Related MCP Connectors
Search YouTube videos, read transcripts and get public video information in your AI assistant.
YouTube search, whole channels, video stats, comments and full transcripts with timestamps.
YouTube transcripts, search, channel/playlist listings and upload tracking for AI agents.
YouTube search: find videos, fetch details and comments, pull full transcripts.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search YouTube for videos, channels, and playlists while retrieving detailed analytics and metrics through the YouTube Data API v3. Supports advanced filtering options and provides comprehensive statistics for content discovery and analysis.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with YouTube through the YouTube Data API, allowing users to search for videos, playlists, and channels, generate video titles using AI, and manage YouTube content through natural language commands.22ISC
- FlicenseBqualityDmaintenanceEnables interaction with YouTube through search and transcript extraction functionality. Allows searching for videos and retrieving full transcripts with timestamps for content analysis.28-
- FlicenseNot gradedqualityNot gradedmaintenanceEnables searching across multiple search engines (Google, Bing, YouTube, DuckDuckGo, etc.) and retrieving parsed search results via SerpApi integration.-