ytb-tools
Provides tools to search YouTube videos, fetch transcripts with language selection, save summaries, and build a local library of transcripts and summaries.
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., "@ytb-tools Search YouTube for the best intro to Rust, then summarize the top result."
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.
š¬ ytb-tools
Search YouTube, pull transcripts, and get AI summaries ā right inside Claude and any other MCP client.
ytb-tools is a Model Context Protocol server that turns YouTube into something your AI assistant can actually work with. Ask it to find videos, grab a transcript, or summarize a talk ā it just works.
⨠Zero setup. No API keys. No Google account. No manual installs. ytb-tools provisions everything it needs on its own.
What you can do
š Search YouTube ā "find me the top React 19 talks" ā ranked results with titles, channels, durations, and views.
š Get transcripts ā full transcripts in the video's language (or any available caption track), saved to a tidy local library.
š§ Summarize videos ā TL;DR, structured notes, or a deep dive ā written by Claude, in the video's own language.
š¾ Builds your library ā every transcript and summary is auto-saved as clean files you can browse, search, and keep.
Related MCP server: youtube-mcp
Quick start
Any MCP client (Claude Desktop, Cursor, Cline, ā¦)
Add this to your client's MCP config ā that's the whole install:
{
"mcpServers": {
"ytb-tools": {
"command": "npx",
"args": ["-y", "ytb-tools"]
}
}
}Then just ask:
"Search YouTube for the best intro to Rust, then summarize the top result."
Claude Code (plugin)
Install it as a plugin to get the slash commands. Run these inside Claude Code:
/plugin marketplace add aliildan/ytb-tools
/plugin install ytb-tools@ytb-toolsThe first command registers this repo as a marketplace; the second installs the plugin (which pulls in the MCP server via npx and adds the slash commands). Prefer a menu? Just run /plugin.
You then get three commands:
Command | What it does |
| List ranked search results |
| Fetch a transcript |
| Summarize at the depth you want |
/yt-summary automatically picks the right model for the job ā quick ā Haiku, standard ā Sonnet, detailed ā Opus ā and writes the summary in the video's language.
Updating the plugin
When a new version ships, refresh the marketplace catalog and update:
/plugin marketplace update ytb-tools
/plugin update ytb-toolsUninstalling
/plugin uninstall ytb-tools@ytb-toolsScripting it? The same actions work non-interactively from your shell:
claude plugin marketplace add aliildan/ytb-tools claude plugin install ytb-tools@ytb-tools
Research a whole topic at once
Installed in Claude Code, the yt-research skill chains everything together. Just ask in plain language:
"Research the top 30 YouTube videos on 'rust async' and give me a digest."
It searches, pulls each transcript, summarizes each (defaulting to quick/Haiku to keep big batches cheap), and produces a combined digest ā recurring themes, a ranked "start here" shortlist, and any videos it had to skip. For large runs it confirms with you first and processes in batches with progress updates.
Your library
Everything is saved automatically (default ~/ytb-tools/):
~/ytb-tools/
āāā transcripts/
ā āāā dQw4w9WgXcQ.en.json # timestamped segments
ā āāā dQw4w9WgXcQ.en.txt # plain text
āāā summaries/
āāā dQw4w9WgXcQ.standard.md # Markdown with title, url, model, dateWant them somewhere else? Set YT_OUTPUT_DIR.
The tools
Tool | Does |
| Search YouTube and return ranked video results |
| Extract a transcript (with language selection), auto-saved |
| Save a generated summary to your library |
Configuration
All optional:
Variable | Purpose | Default |
| Where transcripts & summaries are saved |
|
| Cache location | OS cache dir |
| Use an existing yt-dlp instead of the bundled one | auto |
How it works (the short version)
Search runs entirely in-process via youtubei.js ā no key, no quotas. Transcripts are powered by yt-dlp, which ytb-tools downloads and manages for you automatically the first time you need it (it reuses the Node runtime that's already running ā no Python, no Deno). Summaries are written by your assistant's own model, so there's no extra API bill.
License
MIT Ā© aliildan
Available Tools
3 toolsyoutube_get_transcriptB
Fetch a video's transcript via yt-dlp (cache-aware) and auto-save it to the library. May trigger a one-time yt-dlp download on first use.
Inputs: video (required), lang, fresh.
youtube_save_summaryA
Persist a host-generated summary to the library as Markdown with frontmatter.
Inputs: summary (required), videoId (required), url, model, +3 more.
youtube_searchB
Search YouTube and return ranked video results.
Inputs: query (required), type, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
TDQS
Scored across 3 tools
Each tool targets a unique operation: searching for videos, fetching a transcript, or saving a summary. No overlap in purpose.
All tools follow 'youtube_verb_noun' pattern (get_transcript, save_summary, search). The verb is missing in 'search' but is implicit and consistent with the convention.
Three tools is minimal but reasonable for a focused YouTube assistant. It covers core operations without being overwhelming or too sparse.
The set covers search, transcript retrieval, and summary storage, forming a coherent workflow. Minor gaps like video metadata or playlist listing are acceptable given the narrow scope.
Maintenance
Related MCP Connectors
Search YouTube videos, read transcripts and get public video information in your AI assistant.
Fetch YouTube transcripts, monitor channels and track keyword matches from your AI assistant.
YouTube transcripts, search, channel/playlist listings and upload tracking for AI agents.
YouTube for AI agents: transcripts, comments, video stats, channel monitor, Shorts captions.
Related MCP Servers
- AlicenseAqualityCmaintenanceConnect AI assistants to YouTube: search, transcripts, metadata, and more.1988 npm6MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to fetch transcripts, metadata, and download videos/audio from YouTube without API keys.33MIT
- AlicenseAqualityDmaintenanceEnables AI tools to access YouTube content, including transcript extraction, video/channel info, and search.423 npmMIT
- AlicenseAqualityDmaintenanceEnables AI agents to search, watch, summarize, clip, and extract transcripts from YouTube videos, all without needing an API key or leaving the chat.914 npm67Apache 2.0