An MCP server that provides AI assistants with powerful tools to interact with YouTube, including video searching, transcript extraction, comment
An MCP server that provides AI assistants with powerful tools to interact with YouTube, including video searching, transcript extraction, comment retrieval, and more. That is what the py mcp youtube toolbox mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.
py-mcp-youtube-toolbox provides the following YouTube-related functionalities:
The server publishes 11 tools. What each one is for:
search_videos — Search for YouTube videos with advanced filtering options (channel, duration, region, etc.)get_video_details — Get detailed information about a specific YouTube video (title, channel, views, likes, etc.)get_video_comments — Retrieve comments from a YouTube video with sorting optionsget_related_videos — Find videos related to a specific YouTube videoget_trending_videos — Get trending videos on YouTube by regionget_channel_details — Get detailed information about a YouTube channel (name, subscribers, views, etc.)get_video_transcript — Extract transcripts/captions from YouTube videos in specified languagesget_video_enhanced_transcript — Advanced transcript extraction with filtering, search, and multi-video capabilitiestranscript_summary — Generate summaries of YouTube video content based on transcripts with customizable optionsyoutube — //available-youtube-tools: Get a list of all available YouTube toolsConfiguration — 1. Install UV package manager: bash curl -LsSf https://astral.sh/uv/install.sh | shConfiguration is passed through the environment: YOUTUBE_API_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
The server ships on npm as @smithery/cli, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.
Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Py MCP Youtube Toolbox's toolset — search_videos, get_video_details, get_video_comments and 8 more — is a fair guide to whether it matches your workflow. It is maintained by jikime; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Py MCP Youtube Toolbox's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| search_videos | Search for YouTube videos with advanced filtering options (channel, duration, region, etc.) |
| get_video_details | Get detailed information about a specific YouTube video (title, channel, views, likes, etc.) |
| get_video_comments | Retrieve comments from a YouTube video with sorting options |
| get_related_videos | Find videos related to a specific YouTube video |
| get_trending_videos | Get trending videos on YouTube by region |
| get_channel_details | Get detailed information about a YouTube channel (name, subscribers, views, etc.) |
| get_video_transcript | Extract transcripts/captions from YouTube videos in specified languages |
| get_video_enhanced_transcript | Advanced transcript extraction with filtering, search, and multi-video capabilities |
| transcript_summary | Generate summaries of YouTube video content based on transcripts with customizable options |
| youtube | //available-youtube-tools: Get a list of all available YouTube tools |
| Configuration | 1. Install UV package manager: bash curl -LsSf https://astral.sh/uv/install.sh | sh |
#### for Docker
```json
{
"mcpServers": {
"YouTube Toolbox": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e", "YOUTUBE_API_KEY=your_youtube_api_key",
"py-mcp-youtube-toolbox"
]
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| YOUTUBE_API_KEY | Credential the server authenticates with. | Yes |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.