Advertise
MCP.so
Sign In

YouTube MCP Server

@nattyraz

Repository

Basic information

Category

Media & Design

License

MIT

Transports

stdio

Author

nattyraz

About YouTube MCP Server

A Model Context Protocol (MCP) server for YouTube videos with caption extraction and markdown conversion capabilities

#youtube-mcp#caption-extraction#markdown-conversion

YouTube MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "youtube-mcp-nattyraz": {
      "command": "node",
      "args": [
        "src/get-api-key.js"
      ]
    }
  }
}

YouTube MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is YouTube MCP Server?

YouTube MCP Server is a Model Context Protocol (MCP) server that provides tools for extracting video metadata, captions from YouTube, and converting them to markdown format with various templates. It is designed for developers who want to integrate YouTube data into MCP‑compatible clients (e.g., Roo Cline).

How to use YouTube MCP Server?

Install Node.js v16+, clone the repository, install dependencies (npm install), build the project (npm run build), and configure a .env file with your YouTube Data API key and optionally OAuth2 credentials. Then add the server to your MCP settings file (e.g., ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json) with the command node path/to/build/index.js and the required environment variables. Use tools like get_video_info, get_captions, convert_to_markdown, and list_templates via MCP tool calls.

Key features of YouTube MCP Server

  • Fetch comprehensive video metadata (title, description, etc.)
  • Extract auto‑generated and manual captions
  • Support for English and French captions
  • Three built‑in markdown templates: basic, detailed, and search
  • Search functionality within video captions
  • Flexible authentication: API key or OAuth2

Use cases of YouTube MCP Server

  • Automatically extract video captions for transcription or analysis
  • Convert YouTube videos to structured markdown notes with timestamps
  • Search for specific keywords inside a video’s captions
  • Generate summaries or highlight reels using the search template
  • Integrate YouTube data into AI‑powered workflows via MCP

Frequently asked questions

1

What are the prerequisites for using YouTube MCP Server?

Node.js v16 or higher, npm or yarn, and a YouTube Data API key and/or OAuth2 credentials from the Google Cloud Console.

2

How do I authenticate with YouTube MCP Server?

You can use either a YouTube Data API key (set `YOUTUBE_API_KEY` in `.env`) or OAuth2. For OAuth2, create a Google Cloud project, enable the YouTube Data API v3, generate OAuth2 credentials (Web application type), and run the included authentication script to obtain a refresh token.

3

What markdown templates are available?

Three built‑in templates: **basic** (simple transcript), **detailed** (full metadata with timestamps), and **search** (results highlighting with context). You can also add custom templates by modifying the `DEFAULT_TEMPLATES` array in `src/index.ts`.

4

Can I get captions in languages other than English?

Yes, the server has built‑in support for English (default) and French. You can specify a language code (e.g., `"fr"`) in the `get_captions` or `convert_to_markdown` tool call.

5

How does OAuth2 work for accessing private videos?

OAuth2 is required for private videos. After setting up credentials in the Google Cloud Console, run `node src/get-api-key.js` and follow the browser prompts to authorize. The refresh token is then added to your configuration for persistent access.

Comments

More Media & Design MCP servers

Aura AI

auraai.app

Access 20+ AI video and image models from Google, OpenAI, xAI, ByteDance, and more. Generate and edit videos with Veo 3.1, Sora 2, Seedance, Kling O3, and images with FLUX, Nano Banana, Seedram 4, GPT Image — all in one

Organize with AI (OwAI)

Alexander Visheratin

Search and manage photo and video libraries through AI assistants. Find images and video moments, review duplicates, and organize collections, groups, favorites and people across local folders, Apple Photos and OneDrive.

MagicPixel.art

AI pixel art generator MCP for Claude, ChatGPT, and Cursor. Generate pixel art, remix your own assets, and sync them into Unity or Godot. Create pixel art, remix, edit, and iterate on pixel art game assets including char

InstantClips

InstantStudioAI

InstantClips turns an e-commerce product into short-form vertical video for TikTok, Instagram Reels and Stories. Import a product from its page URL or photos, generate on-brand video ads, and manage brands/products throu

Instagram + TikTok Downloader & Transcriber

IYIA

Instagram + TikTok content tools inside your AI: download HD posts/reels/carousels, view Instagram stories anonymously, AI-transcribe videos (100+ languages, SRT/VTT/TXT). Requires a Repost PRO subscription.

Advertise