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.
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
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
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
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
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 listshows 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-1a2b3cfirst: 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.
Related
Pick a channel of your own
Any YouTube channel you follow. Guruling transcribes every video on it.