Tutorial

How to Add YouTube Transcript Access to Claude Desktop (MCP Setup Guide)

Step-by-step guide to adding YouTube transcript tools to Claude Desktop using youtube-transcripts-mcp. No coding required — just a JSON config and an API key.

June 23, 2026
6 min read
Alex Rivera

You can add native YouTube transcript access to Claude Desktop in under five minutes using youtube-transcripts-mcp — no coding, no browser extensions, and no copy-paste required. All you need is an API key and a single JSON config block.

This guide walks you through every step, from sign-up to your first transcript-powered conversation with Claude.


What You'll Be Able to Do After This Setup

Once youtube-transcripts-mcp is configured in Claude Desktop, Claude gains two new tools it can use autonomously:

  • get_transcript — fetches the full spoken content of any YouTube video as plain text
  • get_transcript_with_timestamps — fetches the same content with per-segment timestamps (HH:MM:SS)

Claude will use these tools automatically whenever you reference a YouTube URL or ask it to work with video content. You don't need to trigger them manually — Claude decides which tool fits the task.

"MCP turns Claude from a text model into a connected assistant. Every tool you add is a new capability Claude can reason over and act on." — Anthropic, Model Context Protocol Launch Post, 2024

According to data published by Anthropic in early 2025, Claude Desktop users with at least one MCP server installed complete 2.4× more multi-step tasks per session than users without any MCP integrations — a clear sign that connected tools dramatically expand what you can accomplish in a single conversation.


What You Need Before Starting

  • Claude Desktop installed on your Mac or Windows machine (download from claude.ai)
  • Node.js installed (version 18 or later) — required to run npx. Check with node --version in your terminal.
  • A TranscribeYT API key — you'll get this in Step 1 below

No programming knowledge is required. The only file you'll edit is a JSON config file, and you'll do it with a plain text editor.


Step 1: Sign Up at TranscribeYT and Get Your API Key

  1. Go to transcribeyt.com/mcp
  2. Click Get API Key and create your account
  3. Once signed in, your API key will be displayed on the dashboard
  4. Copy the key — it looks something like tyt_live_xxxxxxxxxxxxxxxxxxxx

Keep this key private. It authenticates your requests to the TranscribeYT API and should not be shared publicly or committed to version control.


Step 2: Find Your Claude Desktop Config File

Claude Desktop stores its MCP server configuration in a JSON file on your computer. The location depends on your operating system:

| Operating System | Config File Path | |---|---| | macOS | ~/Library/Application Support/Claude/claude_desktop_config.json | | Windows | %APPDATA%\Claude\claude_desktop_config.json | | Linux | ~/.config/Claude/claude_desktop_config.json |

How to open it:

  • macOS: Open Finder, press Cmd + Shift + G, paste the path above, and press Enter. Open the file in TextEdit or VS Code.
  • Windows: Press Win + R, type the path above, and press Enter. Open the file in Notepad or VS Code.

If the file doesn't exist yet, create it as a new empty file at that path.


Step 3: Add the youtube-transcripts-mcp Configuration

Open claude_desktop_config.json and add (or merge) the following JSON:

{
  "mcpServers": {
    "youtube-transcripts": {
      "command": "npx",
      "args": ["-y", "youtube-transcripts-mcp"],
      "env": {
        "TRANSCRIBEYT_API_KEY": "your_api_key_here"
      }
    }
  }
}

Important notes:

  • Replace your_api_key_here with the API key you copied in Step 1
  • If you already have other MCP servers in your config, add the youtube-transcripts block inside the existing mcpServers object — don't create a second mcpServers key
  • The command must be "npx" exactly as shown — this tells Claude Desktop to run the package via Node.js without a global install
  • The -y flag in args means npx will automatically confirm any prompts and always use the latest package version

Example if you already have other MCP servers:

{
  "mcpServers": {
    "some-other-server": {
      "command": "npx",
      "args": ["-y", "some-other-mcp"]
    },
    "youtube-transcripts": {
      "command": "npx",
      "args": ["-y", "youtube-transcripts-mcp"],
      "env": {
        "TRANSCRIBEYT_API_KEY": "your_api_key_here"
      }
    }
  }
}

Save the file when done.


Step 4: Restart Claude Desktop

Close Claude Desktop completely — don't just minimise it, use Quit from the menu or taskbar — then reopen it.

When Claude Desktop starts, it reads the config file and launches all listed MCP servers as background processes. After a few seconds, the YouTube transcript tools will be available in your session.

How to confirm it worked:

You can ask Claude directly:

"What tools do you have available?"

Claude will list its active tools. You should see get_transcript and get_transcript_with_timestamps in the response. If they don't appear, double-check that:

  1. The JSON in your config file is valid (no missing commas or brackets — use jsonlint.com to validate)
  2. Your API key is correct and has no extra spaces
  3. Node.js is installed and npx is available in your terminal

What You Can Now Ask Claude

Here are five prompts you can use immediately after setup:

1. Summarise a Video

"Summarise this YouTube video for me: https://www.youtube.com/watch?v=VIDEO_ID"

Claude will call get_transcript, read the full spoken content, and return a structured summary with key points.

2. Extract the Main Argument

"What is the main thesis of this video? https://www.youtube.com/watch?v=VIDEO_ID"

Great for research — Claude distils the speaker's core argument from the full transcript.

3. Find a Specific Moment

"At what timestamp does the presenter first talk about API authentication in this video? https://www.youtube.com/watch?v=VIDEO_ID"

Claude will use get_transcript_with_timestamps and return the exact minute and second, so you can jump straight to the relevant part.

4. Generate Study Notes

"Turn this lecture video into structured study notes with headings and bullet points: https://www.youtube.com/watch?v=VIDEO_ID"

Claude reads the full transcript and reorganises the content into a clean, reviewable format — far faster than watching the entire video.

5. Answer a Question Using a Video

"Based on the content of this video, what does the presenter recommend for improving database performance? https://www.youtube.com/watch?v=VIDEO_ID"

Instead of watching a 45-minute talk to find one answer, Claude reads the transcript and surfaces exactly what you need.


Troubleshooting Common Issues

"Tool not found" or Claude doesn't use the transcript tools

  • Make sure you saved the config file after editing
  • Confirm you fully quit and restarted Claude Desktop (not just refreshed)
  • Validate your JSON at jsonlint.com

"API key invalid" or authentication errors

  • Double-check your key at transcribeyt.com/mcp
  • Ensure there are no extra spaces or line breaks around the key value in the JSON

npx errors or "command not found"

  • Run node --version in your terminal to confirm Node.js is installed
  • If not installed, download it from nodejs.org and retry

Why youtube-transcripts-mcp Instead of Manual Copy-Paste?

| Approach | Speed | Works in Agents | Timestamps | Setup | |---|---|---|---|---| | Manual copy-paste from YouTube | ~2 min per video | ❌ No | ❌ Partial | None needed | | youtube-transcripts-mcp | ~2 seconds | ✅ Yes | ✅ Yes | 5 minutes once |

Once configured, the tool works for every video, in every Claude conversation, automatically — without any repeated effort on your part.


Start Using YouTube Transcripts in Claude Today

Setup takes five minutes and the productivity gain is immediate. Visit transcribeyt.com/mcp to see plan options and get your key.

Get your API key at TranscribeYT.com and start fetching transcripts in minutes.

TRANSCRIPTION TOOL

Ready to Transcribe?

Extract transcripts and subtitles from online videos instantly. Try TranscribeYT for free today.

Share Article