youtube-caption-mcp
MCP server that extracts YouTube video captions with timestamps. Prefers manual subtitles, falls back to auto-generated. Zero external dependencies.
Quick Start
Install```bash
claude mcp add youtube-caption -- npx -y youtube-caption-mcp
### Remove```bash
claude mcp remove youtube-caption
Prerequisite
- Node.js 18+
Tools
get_transcript
Extract captions from a YouTube video.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
url |
string | yes | - | YouTube video URL or ID |
lang |
string | no | "en" |
Language code (e.g., "en", "tr") |
Returns timestamped captions directly into Claude's context:[0:00] Introduction
[0:15] First topic starts here
[1:02] Second topic begins
get_metadata
Get video metadata including available subtitle languages.
| Parameter | Type | Required | Description |
|---|---|---|---|
url |
string | yes | YouTube video URL or ID |
Returns JSON with title, channel, duration, description, and available subtitle languages.
How it Works
- Uses YouTube's Innertube API directly (no external tools needed)
- Prefers manual subtitles, falls back to auto-generated
- Parses json3 into timestamped text
- Returns captions directly to Claude (no files saved to disk)
License
MIT
