Guruling

MCP server

YouTube transcript MCP server for whole channels

A YouTube transcript MCP server usually fetches one video at a time. Guruling’s keeps every transcript of a channel on its server, so your agent searches all of them in one call and reads only the videos it needs.

Last updated

Connect it

An open channel needs no account and no key. Pick your agent:

Then ask in a new chat, for example: What does Starter Story come back to most often? Name the videos.

Guruling made this, not Starter Story. The words are YouTube’s captions of the videos.

Step by step, with what to do when it doesn’t work: Claude Code, Cursor, Codex.

The three tools

What each tool takes and returns
ToolTakesReturns
search_transcriptsWords to find, and how many videos (up to 20)The videos with the most mentions first, each with its date, its id and short passages
read_transcriptA video’s id, and where to start for the next pageThe transcript word for word, with the title, date, source and link
list_videosOptionally one source, how many to skip and how many to list (up to 200)The transcribed videos, newest first: date, length, title, id and source

All three only read. The server speaks MCP over HTTP: at https://guruling.com/mcp with a guruling’s key, and at https://guruling.com/mcp/<channel> for an open channel.

The search matches words, with a few rules worth knowing. How the search works.

A whole channel, or one video at a time

A single-video transcript server and Guruling, side by side
A single-video serverGuruling
What you give itA video link, each timeA channel, playlist, search or videos, once
Where the transcripts areFetched into the conversation when askedKept on Guruling’s server
Finding a topic across a channelThe agent fetches videos one by oneOne search over every transcript
New uploadsYou fetch them yourselfFound and transcribed for you
TimestampsOften includedNot included
Where it runsOn your machine, usually open sourceHosted, nothing to install
AccountNoneNone for open channels, a free one for your own

If you want the transcript of one video you already have open, a single-video server is the simpler tool. Guruling is for a channel you follow: what was said across all of it, or a plan worked out the way that channel thinks.

Good to know

  • Transcripts are YouTube’s captions. A video without captions can’t be transcribed, and auto-generated captions get names and jargon wrong.
  • There are hourly limits, so in a busy hour your agent may be asked to wait.
  • Guruling sees what your agent searches for and which videos it reads, never your conversation. For an open channel it keeps that without your name for 30 days. More in the privacy policy.

Questions

Is it free?

Open channels are free to read, with no account. A guruling of your own is free to start, with fair hourly limits.

Which agents does it work with?

Claude Code, Codex and Cursor are the ones Guruling gives steps for.

Can I add any channel?

Any public YouTube channel, playlist, search or single video. The videos need captions on YouTube.

Pick a channel of your own

Any YouTube channel you follow. Guruling transcribes every video on it.

Pick a channel