YouTube MCP Server
SurajSongara/youtube-mcp-server
Acesse YouTube, transcrições e metadados direto em agentes Claude
Ver no GitHubServidor MCP que integra YouTube com agentes de IA, permitindo busca de vídeos, extração de transcrições, busca dentro de transcrições e recuperação de metadados. Funciona com Python 3.12+ e usa a API YouTube Data v3, com suporte a matching fuzzy e stemming para buscas inteligentes.
Instalação
npx convez-ai SurajSongara/youtube-mcp-server1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Pesquisar e analisar conteúdo de vídeos do YouTube sem sair do agente
- Extrair e buscar informações específicas em transcrições de vídeos
- Recuperar metadados completos (título, duração, views, likes) de vídeos
- Automatizar análise de conteúdo multimídia com busca fuzzy em transcrições
Veredito

Integração sólida e bem-implementada com YouTube, oferecendo acesso a transcrições sem necessidade de chave API (apenas para busca/metadados). O suporte a busca fuzzy e stemming é um diferencial prático. Recomendado para quem precisa conectar agentes a conteúdo de vídeo em escala.
README
A tradução para o português deste README ainda está na fila.
YouTube Transcript MCP Server
An MCP server that lets AI agents search YouTube, fetch video transcripts, search within transcript text, and retrieve video metadata. Bridges the gap between LLMs and video content.
Tools
| Tool | Description | API Key |
|---|---|---|
search_videos | Search YouTube for videos with filtering and pagination | Required |
get_metadata | Retrieve video metadata: title, description, duration, view count, like count, tags | Required |
get_transcript | Fetch full transcript of a video by URL or ID | None needed |
search_transcript | Search within a video's transcript for specific terms or phrases | None needed |
search_transcript supports fuzzy + stem-aware matching (no external dependencies) — catches typos and variant word forms like "coding" matching "code", "codes", "coder".
Tech Stack
- Python 3.12+
- FastMCP — MCP framework (auto-schema from type hints)
- YouTube Data API v3 — video search and metadata
- youtube-transcript-api — transcript extraction
Getting Started
git clone https://github.com/SurajSongara/youtube-mcp-server
cd youtube-mcp-server
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
echo "YOUTUBE_API_KEY=your_key_here" > .env
python -m src.server
A YouTube Data API key is free from Google Cloud Console (enable YouTube Data API v3). Only search_videos and get_metadata require it; transcript tools work without any key.
MCP Client Config
Add to ~/.config/opencode/opencode.jsonc or opencode.json:
{
"mcpServers": {
"youtube-transcript": {
"command": "python",
"args": ["-m", "src.server"],
"env": {
"YOUTUBE_API_KEY": "your_key_here"
}
}
}
}
Project Structure
src/
├── server.py # FastMCP server (all 4 tools)
└── utils/
└── youtube_api.py # YouTube Data API v3 client
Author
License
MIT