# youtube-transcript-mcp

MCP server that extracts transcripts and metadata from YouTube videos.

## Features

- **Transcript extraction** — clean text output with sentence splitting and abbreviation awareness
- **Timestamped output** — `[XmYs]` prefixed segments for referencing specific moments
- **Language detection** — list available caption tracks (auto-generated vs manual)
- **Video metadata** — title, channel, duration, views, likes, publish date, description

## Installation

```bash
uv sync
```

## Usage

Add to your MCP client config:

```json
{
  "mcpServers": {
    "youtube-transcript": {
      "command": "uv",
      "args": ["--directory", "/path/to/youtube-transcript-mcp", "run", "youtube-transcript-mcp"]
    }
  }
}
```

### Tools

| Tool | Description |
|------|-------------|
| `get_transcript` | Extract transcript text. Supports `timestamps=true` for `[XmYs]` format. |
| `list_languages` | Show available caption languages for a video. |
| `get_video_info` | Get video metadata (title, channel, duration, views, etc.). |

## Development

```bash
# Run tests
.venv/bin/python -m pytest tests/test_server.py -v
```

## License

MIT