youtube-caption-mcp
v2.0.0
Published
MCP server that extracts YouTube video captions using YouTube Innertube API
Downloads
447
Maintainers
Readme
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
claude mcp add youtube-caption -- npx -y youtube-caption-mcpRemove
claude mcp remove youtube-captionPrerequisite
- 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 beginsget_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
