{
  "markdown": "# YouTube Transcript MCP Server\n\n[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)\n[![Python Application](https://github.com/jkawamoto/mcp-youtube-transcript/actions/workflows/python-app.yaml/badge.svg)](https://github.com/jkawamoto/mcp-youtube-transcript/actions/workflows/python-app.yaml)\n[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)\n[![GitHub License](https://img.shields.io/github/license/jkawamoto/mcp-youtube-transcript)](https://github.com/jkawamoto/mcp-youtube-transcript/blob/main/LICENSE)\n[![Dockerhub](https://img.shields.io/badge/Docker-mcp%2Fyoutube--transcript-blue.svg)](https://hub.docker.com/mcp/server/youtube_transcript)\n\n\nThis MCP server retrieves transcripts for given YouTube video URLs.\n\n## Tools\nThis MCP server provides the following tools:\n\n### `get_transcript`\nFetches the transcript of a specified YouTube video.\n\n#### Parameters\n- **url** *(string)*: The full URL of the YouTube video. This field is required.\n- **lang** *(string, optional)*: The desired language for the transcript. Defaults to `en` if not specified.\n- **next_cursor** *(string, optional)*: Cursor to retrieve the next page of the transcript.\n\n### `get_timed_transcript`\nFetches the transcript of a specified YouTube video with timestamps.\n\n#### Parameters\n- **url** *(string)*: The full URL of the YouTube video. This field is required.\n- **lang** *(string, optional)*: The desired language for the transcript. Defaults to `en` if not specified.\n- **next_cursor** *(string, optional)*: Cursor to retrieve the next page of the transcript.\n\n### `get_video_info`\nFetches the metadata of a specified YouTube video.\n\n#### Parameters\n- **url** *(string)*: The full URL of the YouTube video. This field is required.\n\n### `get_available_languages`\nRetrieves the available languages for the video.\n\n#### Parameters\n- **url** *(string)*: The full URL of the YouTube video. This field is required.\n\n## Installation\n> [!NOTE]\n> You'll need [`uv`](https://docs.astral.sh/uv) installed on your system to use `uvx` command.\n\n### For [goose](https://block.github.io/goose/)\nPlease refer to this tutorial for detailed installation instructions:\n[YouTube Transcript Extension](https://block.github.io/goose/docs/mcp/youtube-transcript-mcp).\n\n### For [Claude](https://claude.com/download)\n\nDownload the latest MCP bundle `mcp-youtube-transcript.mcpb` from\nthe [Releases](https://github.com/jkawamoto/mcp-youtube-transcript/releases) page,\nthen open the downloaded `.mcpb `file or drag it into the Claude Desktop's Settings window.\n\n<details>\n<summary>Manually configuration</summary>\n\nYou can also manually configure this server for Claude Desktop.\nEdit the `claude_desktop_config.json` file by adding the following entry under\n`mcpServers`:\n\n```json\n{\n  \"mcpServers\": {\n    \"youtube-transcript\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"--from\",\n        \"git+https://github.com/jkawamoto/mcp-youtube-transcript\",\n        \"mcp-youtube-transcript\"\n      ]\n    }\n  }\n}\n```\nAfter editing, restart the application.\n\n</details>\n\nFor more information,\nsee: [Connect to local MCP servers - Model Context Protocol.](https://modelcontextprotocol.io/docs/develop/connect-local-servers).\n\n### For [LM Studio](https://lmstudio.ai/)\nTo configure this server for LM Studio, click the button below.\n\n[![Add MCP Server youtube-transcript to LM Studio](https://files.lmstudio.ai/deeplink/mcp-install-light.svg)](https://lmstudio.ai/install-mcp?name=youtube-transcript&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnaXQraHR0cHM6Ly9naXRodWIuY29tL2prYXdhbW90by9tY3AteW91dHViZS10cmFuc2NyaXB0IiwibWNwLXlvdXR1YmUtdHJhbnNjcmlwdCJdfQ%3D%3D)\n\n### Using Docker\n\nA Docker image for this server is available on [Docker Hub](https://hub.docker.com/mcp/server/youtube_transcript/).\nPlease refer to the Docker Hub page for detailed usage instructions and documentation.\n\n## Response Pagination\nWhen retrieving transcripts for longer videos, the content may exceed the token size limits of the LLM.\nTo avoid this issue, this server splits transcripts that exceed 50,000 characters.\nIf a transcript is split, the response will include a `next_cursor`.\nTo retrieve the next part, include this `next_cursor` value in your request.\n\nThe token size limits vary depending on the LLM and language you are using.\nIf you need to split responses into smaller chunks,\nyou can adjust this using the `--response-limit` command line argument.\nFor example, the configuration below splits responses to contain no more than 15,000 characters each:\n\n```json\n{\n  \"mcpServers\": {\n    \"youtube-transcript\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"--from\",\n        \"git+https://github.com/jkawamoto/mcp-youtube-transcript\",\n        \"mcp-youtube-transcript\",\n        \"--response-limit\",\n        \"15000\"\n      ]\n    }\n  }\n}\n```\n\n## Using Proxy Servers\nIn environments where access to YouTube is restricted, you can use proxy servers.\n\nWhen using [Webshare](https://www.webshare.io/), set the username and password for the Residential Proxy using either\nthe environment variables `WEBSHARE_PROXY_USERNAME` and `WEBSHARE_PROXY_PASSWORD`,\nor the command line arguments `--webshare-proxy-username` and `--webshare-proxy-password`.\n\nWhen using other proxy servers, set the proxy server URL using either the environment variables `HTTP_PROXY` or\n`HTTPS_PROXY`, or the command line arguments `--http-proxy` or `--https-proxy`.\n\nFor more details, please visit:\n[Working around IP bans - YouTube Transcript API](https://github.com/jdepoix/youtube-transcript-api?tab=readme-ov-file#working-around-ip-bans-requestblocked-or-ipblocked-exception).\n\n## License\n\nThis application is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.\n",
  "bytes": 5893,
  "sha": "2a90f1606511585d3b1c8c63c0e9d6199c7b15ce749e4d7112eb507604fbeac2",
  "repo_slug": "jkawamoto/mcp-youtube-transcript",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_jkawamoto_mcp_youtube_transcri_bfd751c3/readme"
}