io.github.nnnoel/ytranscript-mcp
YouTube transcripts for AI tools. No proxies needed; transcribes videos without captions.
Que pouvez-vous faire avec io.github.nnnoel/ytranscript-mcp ?
- "Summarize this video: https://youtu.be/..."
- "What does the speaker say about pricing, and at what timestamps?"
- "Pull the transcript of this Spanish video and translate it to English."
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
ytranscript-mcpclaude mcp add ytranscript-mcp -e 'YTRANSCRIPT_API_KEY=<your ytranscript_api_key>' -- npx -y ytranscript-mcp@0.1.0
{
"mcpServers": {
"ytranscript-mcp": {
"command": "npx",
"args": [
"-y",
"ytranscript-mcp@0.1.0"
],
"env": {
"YTRANSCRIPT_API_KEY": "<your ytranscript_api_key>"
}
}
}
}
Variables d'environnement
YTRANSCRIPT_API_KEYobligatoire secret API key from https://ytranscript.com/developers (free plan available)
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
ytranscript-mcp
An MCP server that gives Claude, Cursor, VS Code, and other AI tools the transcript of any YouTube video.
- Works from anywhere. Runs fine on AWS, Lambda, Vercel, n8n Cloud, and other cloud hosts. There are no proxies to buy and no IP bans to work around. YouTube blocks most cloud IPs for transcript requests; the yTranscript API handles that for you.
- Handles videos without captions. If a video has no captions, it's transcribed with AI speech-to-text.
- Returns the language actually spoken by default, including on auto-dubbed videos. Pass
langto pick a specific caption track. - Keeps long videos manageable. Choose plain text or timestamped lines, and cap the length so a two-hour video doesn't flood the model's context.
Setup
- Get a free API key at ytranscript.com/developers. The free plan includes 50 units a month, no card required.
- Add the server to your client using one of the configs below.
Claude Code
claude mcp add ytranscript -e YTRANSCRIPT_API_KEY=yk_live_your_key -- npx -y ytranscript-mcp
Claude Desktop
Add this to claude_desktop_config.json. Open it from Settings → Developer → Edit Config.
{
"mcpServers": {
"ytranscript": {
"command": "npx",
"args": ["-y", "ytranscript-mcp"],
"env": { "YTRANSCRIPT_API_KEY": "yk_live_your_key" }
}
}
}
Cursor
Add this to ~/.cursor/mcp.json, or to .cursor/mcp.json in a project:
{
"mcpServers": {
"ytranscript": {
"command": "npx",
"args": ["-y", "ytranscript-mcp"],
"env": { "YTRANSCRIPT_API_KEY": "yk_live_your_key" }
}
}
}
VS Code
Add this to .vscode/mcp.json:
{
"servers": {
"ytranscript": {
"command": "npx",
"args": ["-y", "ytranscript-mcp"],
"env": { "YTRANSCRIPT_API_KEY": "yk_live_your_key" }
}
}
}
Any other MCP client that runs stdio servers works the same way: run npx -y ytranscript-mcp with YTRANSCRIPT_API_KEY set.
Tool: get_transcript
| Argument | Required | Description |
|---|---|---|
video | yes | A YouTube URL (watch, youtu.be, shorts, embed) or an 11-character video ID |
lang | no | Language code of the caption track to fetch, such as en or es. Omit it to get the video's original language |
format | no | text (default) returns plain text. timestamped returns one line per segment with [m:ss] times |
max_characters | no | Cut the transcript at about this many characters. The response says how much was left out |
Things to ask your assistant:
- "Summarize this video: https://youtu.be/..."
- "What does the speaker say about pricing, and at what timestamps?"
- "Pull the transcript of this Spanish video and translate it to English."
Every response ends with the units used and your monthly total, so you can keep an eye on your quota.
Pricing
A transcript from captions costs 1 unit. A video without captions, transcribed with AI, costs 15 units. Failed requests are free.
| Plan | Price | Units per month |
|---|---|---|
| Free | $0 | 50 |
| Starter | $9/mo | 1,000 |
| Developer | $29/mo | 10,000 |
| Scale | $79/mo | 50,000 |
See ytranscript.com/developers for details.
Related
ytranscript-apiis the JavaScript/TypeScript client this server is built on.
License
MIT
Questions fréquentes
Qu'est-ce que io.github.nnnoel/ytranscript-mcp ?
YouTube transcripts for AI tools. No proxies needed; transcribes videos without captions.
Comment installer io.github.nnnoel/ytranscript-mcp ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add ytranscript-mcp -e 'YTRANSCRIPT_API_KEY=<your ytranscript_api_key>' -- npx -y ytranscript-mcp@0.1.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.nnnoel/ytranscript-mcp ?
Oui. Il attend YTRANSCRIPT_API_KEY, à renseigner dans sa configuration.
io.github.nnnoel/ytranscript-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.nnnoel/ytranscript-mcp ?
Il est publié par nnnoel. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.