claude-youtube-transcript
🎬 claude-youtube-transcript
Claude Desktop に YouTube の URL を貼り付けると、動画の完全なトランスクリプトを取得できます。
最小限の MCP サーバーは、Claude に get_transcript というツールを提供し、字幕のある任意の YouTube 動画の字幕を読み取ります。API キー不要、Google アカウント不要、動画のダウンロード不要。テキストトラックだけを連続したブロックとして返すので、モデルは要約・翻訳・引用できます。
✨ できること
あらゆる URL 形式に対応 —
watch?v=、youtu.be/、/shorts/、/embed/、/live/、または 11 文字の裸の ID。スペイン語を優先し、英語にフォールバック。人手による字幕がない場合は自動生成字幕を使います。
youtube-transcript-api0.6 と 1.x に対応 — クラシック API、インスタンス、トラック一覧の順で試します。タイムスタンプや
[Música]マークのない連続したプレーンテキストを返すため、コンテキストを無駄にしません。
Related MCP server: YouTube Transcript MCP Server
📋 必要なもの
Claude Desktop(macOS、Windows、Linux)
PATH 上の Python 3.10 以上
それだけ: API キー不要、Google アカウント不要、
ffmpeg不要。
🚀 クイックインストール
macOS / Linux
git clone https://github.com/Magiprr/claude-youtube-transcript.git && cd claude-youtube-transcript && ./install.shWindows
PowerShell で:
git clone https://github.com/Magiprr/claude-youtube-transcript.git; cd claude-youtube-transcript; powershell -ExecutionPolicy Bypass -File .\install.ps1-ExecutionPolicy Bypass が必要なのは、Windows が既定で署名のないスクリプトをブロックするためです。これはその実行にのみ適用され、システム全体のポリシーを変更しません。
インストーラー(両 OS とも):
📦
pip --break-system-packagesで依存関係をインストールします。🔍
server.pyとpython3バイナリの絶対パスを検出します。💾
claude_desktop_config.jsonに触れる前にバックアップを取ります。🤝 既存の MCP サーバーを上書きせずに、
youtube-transcriptブロックをマージします。🔄 Claude Desktop の再起動を促します(Cmd + Q。ウィンドウを閉じるだけでは不十分です)。
手動インストール
手動で設定する場合は、~/Library/Application Support/Claude/claude_desktop_config.json にこれを追加してください:
{
"mcpServers": {
"youtube-transcript": {
"command": "/opt/homebrew/bin/python3",
"args": ["/ruta/absoluta/a/claude-youtube-transcript/server.py"]
}
}
}どちらのパスも絶対パスである必要があります。Python のパスは which python3(Windows では where python)で取得できます。
ファイルの場所は OS によって異なります:
OS | パス |
macOS |
|
Windows |
|
Linux |
|
Windows では、JSON 内のパスは二重バックスラッシュ(C:\\Users\\tu-usuario\\...)またはスラッシュで記述します。インストーラーが自動的に正しく書き込みます。
🔎 Claude が受け取るもの
ツールは、タイムスタンプやサウンドマークなしのフラットなブロックを返します:
Transcripcion de https://www.youtube.com/watch?v=VIDEO_ID
Hoy vamos a ver como funciona el protocolo MCP y por que cambia la forma
en que las aplicaciones le dan herramientas a un modelo de lenguaje...これにより、モデルはメタデータではなくコンテンツにコンテキストを費やします。
💬 プロンプトの例
Claude Desktop を再起動したら:
Resúmeme este video en 10 bullets: https://www.youtube.com/watch?v=dQw4w9WgXcQExtrae de este video todas las cifras que menciona, con el contexto de cada una:
https://youtu.be/dQw4w9WgXcQTraduce al español la transcripción de https://www.youtube.com/shorts/dQw4w9WgXcQCompara qué dicen estos dos videos sobre el mismo tema:
<url 1>
<url 2>De este video, dame solo las partes donde habla de precios, citadas textual:
<url>🩺 トラブルシューティング
アプリを完全に終了してから開き直してください。macOS では Cmd + Q です。Windows では ✕ を閉じるだけでは不十分で、システムトレイのアイコンを右クリックして Quit を選んでください。どちらも、ウィンドウを閉じるだけではプロセスが終了しません。その後、ブロックが正しく書かれているか確認してください:
python3 -m json.tool ~/Library/Application\ Support/Claude/claude_desktop_config.jsonHomebrew の Python が自分の環境を保護しているためです。インストーラーはすでに --break-system-packages を使っています。手動で実行する場合:
python3 -m pip install -r requirements.txt --break-system-packagesシステムの Python を触りたくない場合は、venv を使い、config の command を /ruta/al/venv/bin/python に指定してください。
Claude Desktop が、依存関係をインストールした Python とは別の Python を使用しています。config に残っている Python を確認し、その Python にパッケージが入っているか確認してください:
/opt/homebrew/bin/python3 -c "import mcp, youtube_transcript_api; print('ok')"すべての動画に字幕があるとは限りません。作者が字幕を無効にしているか、動画が限定公開・年齢制限付きであるか、または進行中のライブ配信である可能性があります。YouTube で CC ボタンがあるか確認してください。
YouTube は IP ごとにリクエストを制限しています。共有ネットワークや VPN でよく発生します。数分待つか、別の接続から試してください。
これは PowerShell の実行ポリシーのためです。次のように実行してください:
powershell -ExecutionPolicy Bypass -File .\install.ps1さらに、Windows がこのファイルをインターネットからダウンロードしたものとしてマークしている場合は、次のようにしてください:
Unblock-File .\install.ps1Windows に組み込まれているエイリアススタブが原因です。python.org から Python 本体をインストールし、"Add python.exe to PATH" にチェックを入れます。インストーラーはインタプリタを探すとき、このスタブをすでに無視しています。
# macOS
tail -f ~/Library/Logs/Claude/mcp-server-youtube-transcript.log# Windows
Get-Content -Wait "$env:APPDATA\Claude\Logs\mcp-server-youtube-transcript.log"🛠️ 開発
手動でサーバーを実行して、起動することを確認できます:
python3 server.pystdio で待機します(これが Claude Desktop との通信方法です)。何も出力されなければ正常です。
📄 ライセンス
MIT © 2026
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI models like Claude to easily access and utilize subtitle data from YouTube videos by extracting transcripts from video URLs with support for multiple languages.1MIT
- AlicenseNot gradedqualityCmaintenanceEnables Claude AI to extract transcripts from YouTube videos with zero setup required. Works on all platforms including mobile, supports multiple languages, and handles all YouTube URL formats through a cloud-hosted service.73MIT
- FlicenseBqualityDmaintenanceExtracts YouTube transcripts and performs AI-powered video analysis for Claude Desktop, enabling transcript retrieval, quality analysis, and smart resource management.8
- AlicenseNot gradedqualityDmaintenanceUnifies YouTube transcripts, YouTube search, and Google NotebookLM into a research pipeline for Claude Desktop and MCP clients.MIT
Related MCP Connectors
YouTube transcripts, search, channels, playlists and bulk transcript jobs for AI agents. 14 tools.
Connect Claude to Fathom meeting recordings, transcripts, and summaries
💯 The fastest YouTube transcript + YouTube search MCP for AI agents. Try for free.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/Magiprr/claude-youtube-transcript'
If you have feedback or need assistance with the MCP directory API, please join our Discord server