mcp-youtube-transcript

jkawamoto/mcp-youtube-transcript

3.5

If you are the rightful owner of mcp-youtube-transcript and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This MCP server retrieves transcripts for given YouTube video URLs.

Tools
1
Resources
0
Prompts
0

YouTube Transcript MCP Server

Python Application GitHub License pre-commit Ruff smithery badge Dockerhub

This MCP server retrieves transcripts for given YouTube video URLs.

YouTube Transcript Server MCP server

Tools

This MCP server provides the following tools:

get_transcript

Fetches the transcript of a specified YouTube video.

Parameters
  • url (string): The full URL of the YouTube video. This field is required.
  • lang (string, optional): The desired language for the transcript. Defaults to en if not specified.
  • next_cursor (string, optional): Cursor to retrieve the next page of the transcript.

Installation

[!NOTE] You'll need uv installed on your system to use uvx command.

For codename goose

Please refer to this tutorial for detailed installation instructions: YouTube Transcript Extension.

For Claude Desktop

To configure this server for Claude Desktop, edit the claude_desktop_config.json file with the following entry under mcpServers:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-youtube-transcript",
        "mcp-youtube-transcript"
      ]
    }
  }
}

After editing, restart the application. For more information, see: For Claude Desktop Users - Model Context Protocol.

For LM Studio

To configure this server for LM Studio, click the button below.

Add MCP Server youtube-transcript to LM Studio

Installing via Smithery

[!NOTE] When using this method, you will be utilizing servers hosted by Smithery. Requests and responses will be routed through their servers. Please refer to the Smithery Privacy Notice for information about their data handling practices.

The Smithery CLI enables the installation of MCP servers on various clients.

For instance, to install this server for Claude Desktop, execute the following command:

npx -y @smithery/cli install @jkawamoto/mcp-youtube-transcript --client claude

To view the list of clients supported by the Smithery CLI, use this command:

npx -y @smithery/cli list clients

Refer to the Smithery CLI documentation for additional details.

Response Pagination

When retrieving transcripts for longer videos, the content may exceed the token size limits of the LLM. To avoid this issue, this server splits transcripts that exceed 50,000 characters. If a transcript is split, the response will include a next_cursor. To retrieve the next part, include this next_cursor value in your request.

The token size limits vary depending on the LLM and language you are using. If you need to split responses into smaller chunks, you can adjust this using the --response-limit command line argument. For example, the configuration below splits responses to contain no more than 15,000 characters each:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-youtube-transcript",
        "mcp-youtube-transcript",
        "--response-limit",
        "15000"
      ]
    }
  }
}

Using Proxy Servers

In environments where access to YouTube is restricted, you can use proxy servers.

When using Webshare, set the username and password for the Residential Proxy using either the environment variables WEBSHARE_PROXY_USERNAME and WEBSHARE_PROXY_PASSWORD, or the command line arguments --webshare-proxy-username and --webshare-proxy-password.

When using other proxy servers, set the proxy server URL using either the environment variables HTTP_PROXY or HTTPS_PROXY, or the command line arguments --http-proxy or --https-proxy.

For more details, please visit: Working around IP bans - YouTube Transcript API.

License

This application is licensed under the MIT License. See the file for more details.