Guruling

Codex

YouTube MCP for Codex: search a channel’s transcripts

Codex can search a YouTube channel’s transcripts through an MCP server. One command adds a channel that Guruling has transcribed, and Codex can then find what was said in any video and read it in full.

Last updated

Add an open channel with one command

Starter Story’s channel is open on Guruling, with no account and no key. Run this once in your terminal:

Then start Codex and ask, for example: Find the Starter Story interview closest to a builder with no revenue. What was he told to do?

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

What a session looks like

Find the Starter Story interview closest to a builder with no revenue. What was he told to do?

search_transcripts "no revenue"

6 videos

read_transcript He built 100 apps and made $0. Can he fix it in 30 days?

  • A builder with 72 apps and no revenue took a 30-day challenge from Pat Walls.

    He built 100 apps and made $0. Can he fix it in 30 days? · 22 Aug 2026

  • Stop building: no new features, projects or ideas for 30 days.

  • Two customer conversations a day, by phone or in person.

  • Post once a day on one platform, documenting the journey.

  • He made about $100 in the first 30 days and $6,500 after 60.

A real session in Codex, run on on Starter Story’s open guruling.

Codex searched first, then read the one video that fit in full, so the answer comes from the whole interview and not from a passage.

Codex gets three read-only tools: one searches the transcripts, one reads a video, one lists the videos. What each one takes and returns.

Connect a channel of your own

  1. 1

    Add the channel

    Paste a channel, playlist or video link at guruling.com and sign in with your email or Google. Guruling lists the videos.

  2. 2

    Pick what to transcribe

    Choose a few videos or all of them. Transcribing runs on Guruling’s server from YouTube’s captions, so you can close the tab, and new uploads are found for you.

  3. 3

    Make a key and add the block

    On the guruling’s page choose Connect to an agent, make a key and copy the block for Codex to the end of ~/.codex/config.toml.

  4. 4

    Ask

    Start Codex and name the guruling: using my Marketing guruling, list what they said about cold email, with the videos.

With a key it is a block and not a command: codex mcp add takes a key only from an environment variable, which would have to be set wherever Codex starts.

If something doesn’t work

  • codex mcp list shows the server. A guruling with a key is listed with bearer auth.
  • Put the block at the end of config.toml. A TOML table takes in every setting after it, so in the middle of the file it would swallow the ones below.
  • Connecting again with another key? Run codex mcp remove guruling-marketing-1a2b3c first: a second block of the same name breaks the whole file.
  • The search matches words, not meaning. If little comes back, ask for another word for the same thing. How the search works.

Questions

Does Codex have to fetch YouTube itself?

No. Guruling has the transcripts already, made from YouTube’s captions on its own server. Codex only asks Guruling.

Can Codex read one video in full?

Yes. read_transcript returns a video word for word, in pages when it is long.

What does it cost?

It is free to start, with fair hourly limits. Transcripts stay free.

Pick a channel of your own

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

Pick a channel