BulkTranscripts logo BulkTranscripts
Integration guide · 30 free credits

Use YouTube transcripts in Codex

Point Codex at one remote MCP server and it can read any YouTube video, channel, or playlist as text.

Setup steps ↓
Codex · setup
codex plugin marketplace add pratie/bulktranscripts-mcp codex plugin add bulktranscripts@bulktranscripts codex mcp login bulktranscripts
One Google sign-in, 30 free credits.
30free credits to startGoogle sign-in, no card
1,000videos per bulk joba whole channel or playlist
$0to read a video againyour library stays free
Nevercredits expireone-time packs, no subscription
00:20How it works

Two steps from install to answers

11 minute

Install the plugin

Add the BulkTranscripts marketplace, install the plugin, then sign in with Google once. It brings the MCP server and the skill together.

codex plugin marketplace add pratie/bulktranscripts-mcp codex plugin add bulktranscripts@bulktranscripts codex mcp login bulktranscripts
210 seconds

Ask Codex in plain words

Codex picks the right tool by itself. You never name one.

00:30Setup

Step by step

Option 1: Codex plugin (recommended)

BulkTranscripts is a Codex plugin: one install brings the MCP server and a skill that tells Codex when to use each tool. Add the marketplace, install, then sign in with Google once:

codex plugin marketplace add pratie/bulktranscripts-mcp
codex plugin add bulktranscripts@bulktranscripts
codex mcp login bulktranscripts

The source is public at pratie/bulktranscripts-mcp. In the Codex app, open Settings → Plugins, choose Add more and paste https://github.com/pratie/bulktranscripts-mcp.git.

Option 2: MCP server in config.toml

On a Codex build without plugins, add the remote (streamable HTTP) server to ~/.codex/config.toml yourself:

[mcp_servers.bulktranscripts]
url = "https://bulktranscripts.co/mcp"

Then run codex mcp login bulktranscripts to sign in with Google. On builds without MCP OAuth, use the key-in-URL form; it behaves identically:

[mcp_servers.bulktranscripts]
url = "https://bulktranscripts.co/mcp?key=YOUR_API_KEY"

Nothing to buy for that: create a free API key in the app. Sign in with Google at bulktranscripts.co/app, then MCP & API → API keys → Create key. It includes the 30 free credits and works on the MCP endpoint and the REST API alike. A license key from a credit-pack purchase works in the same slot.

Option 3: agent skill

Codex reads Agent Skills (SKILL.md folders) too:

mkdir -p ~/.codex/skills/youtube-transcripts
curl -fsSL https://bulktranscripts.co/skill.md \
  -o ~/.codex/skills/youtube-transcripts/SKILL.md

The skill teaches Codex the plain REST API, so it works even on Codex builds without remote-MCP support. It just needs curl.

Try asking

  • Summarize this video and pull the key quotes: https://youtube.com/watch?v=…
  • What has @TED published about AI? Fetch the three most relevant transcripts.
  • Check if @mkbhd uploaded anything this week and brief me on it.
  • Get every transcript in this course playlist and turn it into study notes.

Notes

Connecting the MCP server takes one sign-in (Google or a license key) and includes 30 free credits, no card needed. Buying a one-time credit pack gets you a license key that doubles as the API key; credits never expire and repeat reads from your own library are free.

On older Codex versions, verify MCP support with codex mcp --help; if your build only supports stdio servers, use the skill instead.

00:50Pick a way in

Which setup fits you

All of them share one account, one credit balance and one library.

Way inHow you connectSign-inBest for
Codex plugincodex plugin add bulktranscripts@bulktranscriptsGoogle, via codex mcp loginMost people. MCP server and skill in one install
MCP server[mcp_servers.bulktranscripts] in config.tomlGoogle, or a key in the URLBuilds without plugin support
Agent skillSKILL.md in ~/.codex/skillsBULKTRANSCRIPTS_API_KEYBuilds without remote MCP; only needs curl
REST APIPlain curl callsAPI keyScripts Codex writes for you
01:10Try asking

What to ask Codex

Paste any of these once the server is connected.

Migration notes

“Read this release talk and list every breaking change that affects this repo.”

Tutorial to code

“Follow this tutorial video and scaffold the same project here: https://youtube.com/watch?v=…”

Library research

“Find the three most-watched videos on Bun vs Node and summarize the trade-offs.”

Docs from talks

“Turn this conference talk into a docs/ page with the architecture it describes.”

Changelog watch

“Check @vercel for new uploads this week and note anything about Next.js.”

Quote check

“Did the speaker really recommend this pattern? Quote the line and timestamp.”

01:20Whole channels

Shorts, live streams and big channels

One background job per channel, in Codex or any other client.

Shorts

“Get the transcripts of every Short on @mkbhd.” The job reads the channel's Shorts tab instead of its regular uploads.

Past live streams

“Pull the transcripts of @NASA's live streams.” Streams that haven't started or are still running are skipped, since they have no transcript yet.

Past 1,000 videos

A job takes up to 1,000 videos. For a bigger channel, Codex runs the next block from video 1,001; anything already in your library comes back free.

01:30Which one

Codex or ChatGPT?

Both are OpenAI. The setup is different.

Codex CLI

A terminal coding agent. One block in config.toml or the skill. Best when the transcript should change files.

ChatGPT

The chat app. Add the official plugin, free plans too. Best for reading, summaries and research. ChatGPT guide

01:50Other agents

Use it in your other tools too

Same account and credits everywhere. Your library follows you.

02:10Questions

Questions about Codex

How do I add BulkTranscripts to Codex?

Install the plugin: run codex plugin marketplace add pratie/bulktranscripts-mcp, then codex plugin add bulktranscripts@bulktranscripts, then codex mcp login bulktranscripts and sign in with Google. On builds without plugins, add [mcp_servers.bulktranscripts] with url = "https://bulktranscripts.co/mcp" to ~/.codex/config.toml instead.

My Codex build has no remote MCP support. Can I still use it?

Yes. Install the agent skill instead: it teaches Codex the plain REST API, so all it needs is curl and a free API key in BULKTRANSCRIPTS_API_KEY.

Is BulkTranscripts free to use in Codex?

You start with 30 free credits when you sign in with Google, no card needed. One credit fetches one new transcript. Reading a transcript that is already in your library is free, and checking a channel for new uploads is free. After that, one-time credit packs that never expire; there is no subscription.

Does every YouTube video have a transcript?

No. A transcript can only be fetched when the video has captions, either uploaded by the creator or generated by YouTube. Videos without captions are skipped and never charged.

Can Codex read a whole channel or playlist?

Yes. Ask for a channel or playlist and the server lists the videos, then fetches their transcripts. Large jobs of up to 1,000 videos run on the server in the background and report progress, so they survive a long conversation. A bigger channel runs in blocks (videos 1 to 1,000, then 1,001 to 2,000), and the job says where the next block starts. Ask for the channel's Shorts or its past live streams and the job reads that tab instead of regular uploads.

02:30Go deeper

The same engine, three other ways in

Connect it in Codex

30 free credits, no card. One sign-in for the MCP connector, one free API key for the REST API.

Get your free credits

Updated