YouTube Transcript MCP Server
for Claude, Cursor and VS Code

Add one URL to Claude and approve in your browser. No API key to copy. Your assistant can then pull the transcript for any video that has captions, and search the channels you have TranscriptHook watching. Nothing to install. It runs on the free plan.

Is there a YouTube MCP server?

Yes, a few. TranscriptHook is a hosted one at https://transcripthook.com/mcp. Add that URL to Claude Code, claude.ai, Cursor, VS Code or ChatGPT, approve once in your browser, and the assistant can fetch the transcript of any YouTube video that has captions. It can also read the channels you monitor. Nothing runs on your machine.

Is it free?
The free plan costs $0 and includes 10 transcript lookups and 1 monitored channel a month. Starter is $9 a month for 15 channels and 500 lookups. Free open-source servers also exist, and the comparison below says when they are the better pick.
Is it official?
No. TranscriptHook is an independent service. It is not made by YouTube, Google or Anthropic.
Does it work in Claude Code?
Yes. One command, then /mcp to approve. The Claude Code steps are below.
Is it a Claude skill?
It is a connector, not a skill file. The connector gives Claude tools it can call. Nothing to download or keep updated.
Just want a summary?
The guide to summarizing YouTube videos with Claude covers that in plain steps.

11 tools your assistant can call

TranscriptHook speaks the Model Context Protocol at https://transcripthook.com/mcp over Streamable HTTP, protocol version 2025-03-26. Point any MCP client at it and 11 tools show up in the assistant's tool list.

Seven of them read: fetch a transcript, list what your channels posted recently, search your history by keyword, list your channels, check your plan usage, read a channel's keyword filter, and list the videos that matched your keywords. Four write: add a channel, pause one, delete one, set a keyword filter. The write tools respect the same plan limits as the dashboard, because they run the same code behind it.

Worth knowing: questions about channels you already monitor are answered from stored history, so they cost nothing. A credit is only spent when the assistant has to go and fetch a transcript TranscriptHook has never seen.

Two minutes, one approval

The server runs on our side, so setup is a URL and a browser approval rather than a package and a runtime.

Pick your client. Each one connects through your browser: log in to TranscriptHook, check the approval screen, which names the app, the account and the address you will be sent back to, and approve. Revoke any app in Dashboard → Connect & API keys.

Claude Code

claude mcp add --transport http transcripthook https://transcripthook.com/mcp

Then run /mcp in Claude Code and choose Authenticate. Your browser opens; log in and approve. This is the setup for a YouTube transcript in Claude Code. After that, paste any YouTube link and ask for what you need: "Get the transcript for https://youtu.be/… and summarize the key points."

Claude.ai & Desktop

Add to Claude

If the form doesn't open pre-filled: Settings → Connectors → Add custom connector, name it TranscriptHook and paste https://transcripthook.com/mcp. Claude Desktop uses the same connectors as your claude.ai account.

ChatGPT

In ChatGPT, open Settings → Apps & Connectors, turn on Developer mode under Advanced, then create a connector with this URL and OAuth authentication: https://transcripthook.com/mcp

VS Code

Install in VS Code VS Code Insiders

VS Code opens, adds the server, and asks you to sign in to TranscriptHook in your browser.

Cursor

Add to Cursor

Cursor desktop signs in through your browser. If sign-in fails (older Cursor versions or Cloud Agents), use the API key method under Other clients.

Apps connected through the browser can read your data and add, pause or resume channels. Removing channels is never granted to them. Manage them under Connected apps in Dashboard → Connect & API keys.

Once connected, try "what did my channels post in the last 24 hours?" That is get_recent_videos, and it costs nothing. Transcripts come back as full text, so the assistant can summarise or quote from them directly.

Other clients

Anything without OAuth support, and Cursor versions where browser sign-in fails, send an API key as a header instead. Create one in Dashboard → Connect & API keys (the same kind of key as the REST API; you can create several named keys, and the full key is shown only once because keys are hashed at rest). Claude Desktop's config file is ~/.config/claude/claude_desktop_config.json. Cursor keeps its config under Settings → MCP.

{
  "mcpServers": {
    "transcripthook": {
      "url": "https://transcripthook.com/mcp",
      "headers": {
        "Authorization": "Bearer tr_live_xxxxxxxxxxxx"
      }
    }
  }
}

What each tool does, and what it costs

Only get_transcript spends anything. Everything that reads your own monitored history is free on every plan, so an assistant can look around your account as much as it likes without touching your credits.

ToolWhat it doesCost
get_transcript Full transcript and the video description for any YouTube video, by ID or URL. The video does not have to be one you monitor 1 credit per successful fetch
get_recent_videos Everything your monitored channels published inside a time window (since: "24h", "7d"), transcripts and descriptions attached Free
search_videos Keyword search across your subscription history. Matches titles and the transcript text itself. Results include each video's description, but the description is not searched Free
list_channels Your monitored channels with their latest video. Each row carries the subscription_id the write tools take Free
get_account_status Plan, channels and webhooks used against their limits, credits left and when they reset, rate limit, poll interval Free
add_channel Start monitoring a channel by @handle, URL or UC… ID. Ask for one you already monitor and you get the existing subscription back, not a duplicate. Counts against your plan's channel limit Free
set_channel_active Pause or resume a channel. Paused channels are skipped by the poller but keep every stored video and transcript. A paused channel still holds its slot against the channel limit Free
get_keyword_filter The keyword filter on each channel (or one), and whether your plan actually applies it Free
set_keyword_filter Set, change or clear a channel's keyword filter. With one, the channel's webhook fires only for videos whose title or full transcript contains a keyword (whole words, case-insensitive). Available on every plan Free
get_keyword_matches Videos that matched your keywords since a point in time, with the matching quotes and each video's description. Built for a scheduled routine to poll: pass the last response's next_since. Uses each channel's saved filter, or keywords you pass in Free
remove_channel Permanently deletes a channel and every video, transcript and delivery record under it. Off unless you enable destructive tools for the key — see below Free
remove_channel is off by default. Until the account owner enables destructive tools in Dashboard → Settings (an account setting for API keys, never for browser-approved apps), the tool is stripped out of the tool list, so your assistant is never told it exists. With the flag on it still needs an explicit confirm. The setting changes only when you toggle it; revoking a key does not switch it back on or off.

The reason for a dashboard toggle rather than just a confirmation prompt: transcripts are written by the channel owner, not by you. A video whose captions carry instructions aimed at your assistant is a real thing, and the confirm flag is something the model decides to set. A toggle in your account is the part of that gate no text your assistant reads can flip. Deletion cascades and we keep no per-account backup, so it is worth the extra click.

There are free open-source alternatives. Here is when they win.

Search npm or GitHub for a YouTube MCP server and you will find several good ones, such as kimtaeyoon83/mcp-server-youtube-transcript, jkawamoto/mcp-youtube-transcript, and projects from hancengiz and ergut. They install in a minute, they cost nothing, and for grabbing the transcript of a video someone just sent you, they do the job. If that is your whole use case, use one of those. We would rather say so than pretend otherwise.

What they have in common is where they stop.

They fetch from your IP

A local server asks YouTube for captions from wherever it happens to be running, and YouTube blocks addresses it does not like — data-centre ranges especially. Nothing in the package can do anything about that. TranscriptHook is built to keep working where DIY scrapers get blocked.

They only look things up

Every one of them takes a video and returns its transcript. None of them watch a channel, so none can answer "what did these twelve channels publish this week" or "which of my channels mentioned pricing changes". TranscriptHook keeps that history for you, and search_videos runs over the transcript text, not just titles.

They install per machine

A local server means Node or Python on that box, a config entry on that box, and doing it again on your laptop, your desktop and anywhere else. It also rules out Claude on your phone and Claude on the web, which cannot run a local process at all. TranscriptHook is one URL and a browser approval, the same everywhere.

Capability Open-source transcript MCP servers TranscriptHook MCP
Getting a transcript
Transcript by video ID or URL ✓ Core feature ✓ get_transcript
Survives a YouTube IP block ✗ Your address, your problem ✓ Built for where DIY scrapers get blocked
Price per transcript ✓ Free, unmetered 1 credit 10/mo free, 500/mo on Starter
Working across channels
Monitors channels for new uploads ✗ ✓ Checked about every 10 minutes, with stored history
"What did my channels post this week?" ✗ ✓ get_recent_videos, free
Full-text search over past transcripts ✗ ✓ search_videos, free
Assistant can add or pause channels ✗ ✓ Same plan limits as the dashboard
Running it
Install per machine ✗ Node or Python on every box ✓ Nothing to install
Works on Claude mobile and web ✗ Local process only ✓ Remote server over HTTP
You control the code ✓ Fork it, patch it, audit it ✗ Hosted service
Destructive actions gated outside the model n/a Nothing to destroy ✓ Per-key toggle you set in the dashboard

Things worth asking once it is connected

Each of these maps to one or two tool calls. The assistant works out which. New to this? See how to get a YouTube transcript into Claude and summarize videos. Prefer plain HTTP? The same transcripts come from the YouTube transcript API.

The morning catch-up

"Summarise everything my channels posted in the last 24 hours, grouped by topic." One get_recent_videos call, transcripts included, no credits spent.

Finding the quote you half-remember

"Search my channels for anything mentioning interest rates this month and give me the exact wording." search_videos reads the transcript body, so it finds things no title contains.

The links in a video

"Check this week's videos from the channel that reviews AI tools, pull out the GitHub repos in the descriptions and tell me which are worth a look." The description comes back with each video; your assistant reads the links out of it.

A video someone sent you

"Pull the transcript for this link and tell me if it says anything about the pricing change." get_transcript takes the bare URL and spends one credit.

Tidying the watchlist

"Which channels haven't posted in 60 days? Pause those." list_channels then set_channel_active. Paused channels keep their stored transcripts.

Checking the meter

"How many transcript credits do I have left, and when do they reset?" get_account_status answers without spending one, which is the point of it being free.

Adding a channel mid-conversation

"Start monitoring @Bloomberg, tag it finance." add_channel takes a handle, a URL or a UC… ID, and hands back the existing subscription if you already had it.

Common questions

Is there a YouTube MCP server?
Yes. TranscriptHook runs a hosted one at https://transcripthook.com/mcp, and there are free open-source ones you install yourself. The hosted one needs no install, works on phone and web clients, and can also watch channels. The open-source ones are fine for fetching one transcript at a time.
Is there a free YouTube MCP server?
Yes, two ways. The TranscriptHook free plan costs $0 and includes 10 transcript lookups and 1 monitored channel a month, with every MCP tool available. Open-source servers are free with no cap, but you run them on your own machine. See the comparison above for when each fits.
Is TranscriptHook an official YouTube MCP server?
No. It is an independent service, not made by or affiliated with YouTube, Google or Anthropic. It reads public captions the same way a viewer sees them, so it only works for videos that have captions.
Does it work with Claude Code?
Yes. Run claude mcp add --transport http transcripthook https://transcripthook.com/mcp, then /mcp and choose Authenticate. Your browser opens, you log in and approve. After that, paste a YouTube link in Claude Code and ask for the transcript or a summary.
Is this a Claude skill?
No, it is an MCP connector. A skill is a folder of instructions Claude loads. A connector gives Claude tools it can call, such as fetching a transcript. You add it with a URL and a browser approval, and there is nothing to download.
Can I use it as a YouTube transcript API for Claude?
Yes. In Claude, the MCP tools are the API: get_transcript takes a video ID or URL and returns the full text. If you want plain HTTP from your own code instead, the YouTube transcript API returns the same transcripts.
Do I need a paid plan to use the MCP server?
No. MCP is on every plan, free included. A free account monitors 1 channel and gets 10 on-demand transcript lookups a month, which is enough to find out whether this fits how you work. The tools that read your own monitored history cost nothing on any plan.
Does it work with Claude mobile and Claude on the web?
Yes. It is a remote server over Streamable HTTP at https://transcripthook.com/mcp, not a local process. Any client that accepts a remote MCP URL can reach it: Claude Code, Claude Desktop, claude.ai, ChatGPT, VS Code and Cursor. These connect with a one-time browser approval (OAuth). Clients without OAuth use an API key header. Same URL everywhere, no per-machine setup.
Do I need an API key to connect?
Not for Claude Code, Claude Desktop or claude.ai. They connect with OAuth, so you log in and approve in the browser and there is nothing to copy. Revoke any connected app in Dashboard → Connect & API keys. Apps connected this way can read your data and add, pause or resume channels, but never delete them. Clients without OAuth use an API key, the same kind as the REST API, created on the same page. MCP and REST share one rate limit per key. Keys are stored hashed, so create a key to get a usable one. You can keep several named keys and revoke one without affecting the others. No YouTube API key is needed either way.
What happens if I ask it to add a channel I already monitor?
You get the existing subscription back rather than a second copy of it. add_channel treats @Bloomberg, youtube.com/@Bloomberg and the bare UC… ID as the same channel, and a unique constraint in the database catches anything the matching misses. Two subscriptions to one channel would mean every new video delivered twice, so this one is worth being strict about.
Can the assistant set up webhooks for me?
No, and that is deliberate. A webhook is an outbound POST from our servers to an address someone chose, so it stays behind your logged-in session in the dashboard rather than behind an API key. MCP clients read with get_recent_videos anyway, so there is little reason to hand that surface to a tool call.
Should I use this or one of the free open-source servers?
If you want to paste a link and read a transcript, install a free one. They work. Come here when the local fetch starts failing on YouTube's blocks, when you want questions answered across a set of channels rather than one video, or when you need the same tools on your phone as on your laptop.

Connect TranscriptHook to your assistant

The free plan includes the full MCP server, 1 monitored channel and 10 transcript lookups a month.

No credit card · Free tier forever