MCP Directory

How to add YouTube Transcript MCP Server to Cursor

Fetch YouTube video transcripts (plain or timestamped), metadata, and available caption languages — no API key. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 14, 2026 · 416★ · stdio · no auth

Cursor config for YouTube Transcript MCP Server

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

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

  1. 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the YouTube Transcript MCP Server config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of YouTube Transcript MCP Server's tools to confirm it's connected.

Before you start

  • uv installed (provides the uvx command)
  • No YouTube API key or account needed
  • Optional: Webshare or HTTP/HTTPS proxy credentials if your network/IP is blocked by YouTube

What YouTube Transcript MCP Server can do in Cursor

get_transcript

Fetch a video's transcript by URL, optional language (default en), paginated via next_cursor.

get_timed_transcript

Fetch the transcript with timestamps, same URL/lang/cursor parameters.

get_video_info

Fetch metadata for a video URL.

get_available_languages

List caption languages available for a video.

Security

Read-only against public YouTube caption data with no credentials to leak. YouTube rate-limits and sometimes IP-bans automated transcript fetching (especially from cloud IPs); if you configure Webshare or HTTP proxies, those proxy credentials go in env vars, and your traffic routes through the proxy provider.

YouTube Transcript MCP Server + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the YouTube Transcript MCP Server config there under the "mcpServers" key and restart the client.

Is YouTube Transcript MCP Server safe to use with Cursor?

Read-only against public YouTube caption data with no credentials to leak. YouTube rate-limits and sometimes IP-bans automated transcript fetching (especially from cloud IPs); if you configure Webshare or HTTP proxies, those proxy credentials go in env vars, and your traffic routes through the proxy provider.

Is it free, and do I need a YouTube API key?

Free and no API key: it reads caption data the same way youtube-transcript-api does, without OAuth or Google Cloud setup. The only potential cost is an optional proxy subscription if YouTube blocks your IP.

What happens with very long videos?

Transcripts over 50,000 characters are split automatically; the response includes a next_cursor you pass to the next call to continue. You can shrink chunks further with the --response-limit argument.

Why do I get blocked/empty results on a server?

YouTube aggressively blocks transcript requests from datacenter IPs. The README's fix is a residential proxy — set WEBSHARE_PROXY_USERNAME/PASSWORD (Webshare) or HTTP_PROXY/HTTPS_PROXY for a generic proxy.

View repo Full YouTube Transcript MCP Server page