Skip to main content
plugin CX Codex

bulktranscripts — Claude Code plugin: YouTube transcripts

bulktranscripts — a hosted MCP server that pulls YouTube captions for a single video, a whole channel or a playlist and hands them to your agent as text. It also searches YouTube and watches for new uploads.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install bulktranscripts@awesome-codex-plugins
Open on GitHub

What bulktranscripts does

The plugin points your agent at https://bulktranscripts.co/mcp, a Streamable HTTP endpoint. From there it fetches one transcript, batches up to 20 videos in a single call, lists up to 1,000 uploads from a channel or a playlist in order, and searches YouTube by keyword or inside one channel. Extraction happens server-side, proxy rotation and PO-token handling included, so nothing runs on your machine. All tools are read-only. A Codex manifest and a youtube-transcripts skill ship in the same repo.

Read a video once and its text lands in your library; later reads in any format cost nothing, which stops an agent from paying twice for the same link. get_latest_videos is free on every call, so the cheap pattern is to poll for fresh uploads and spend a credit only on what is actually new. Send a channel, playlist or video URL past 20 items through start_bulk_extract and you get a run_id straight away; get_bulk_status reports progress and says when to poll again.

Google OAuth sign-in comes with 30 free credits. After that, one-time packs: $4.99 for 200 credits, $14.99 for 1,200, $29 for 5,000, no subscription and no expiry. A client that cannot run OAuth passes a bt_ak_… key in the Authorization header, or appends ?key= to the URL when it cannot set headers at all. Call /mcp without either and you get a 401.

What it helps with

  • Pull captions from a whole channel while you keep working
  • Find a talk on a topic inside one channel
  • Spot new uploads without spending credits
  • Turn a video into text for summarising
  • Batch 20 videos into one transcript call

Example prompts for the agent

  • Grab the transcripts of @veritasium's last 10 videos and flag the ones about quantum mechanics.
  • Search the Y Combinator channel for founder mode talks and pull their transcripts.
  • Start start_bulk_extract for this playlist, then poll get_bulk_status until it finishes.

How to install bulktranscripts

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install bulktranscripts@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about bulktranscripts

How do I install bulktranscripts in Claude Code?

From the marketplace: first /plugin marketplace add hashgraph-online/awesome-codex-plugins, then /plugin install bulktranscripts@awesome-codex-plugins. Sign in with Google OAuth after that.

What does bulktranscripts do?

It returns YouTube captions for one video, a channel or a playlist as text with metadata. It also searches YouTube and checks a channel for new uploads for free.

Do I need an API key?

With OAuth you just sign in through Google and get 30 free credits. A bt_ak_… key is for clients that cannot do OAuth; send it in the Authorization header or add ?key= to the URL.

Source text

bulktranscripts-mcp · MIT
# BulkTranscripts MCP server

YouTube transcripts for AI agents — one video, a whole channel, or a playlist —
plus YouTube search and free new-upload tracking, through one hosted
[MCP](https://modelcontextprotocol.io) server. No local process, no `yt-dlp`
to keep fresh, no IP blocks to fight: extraction, proxy rotation and PO-token
handling all happen server-side.

- **Endpoint:** `https://bulktranscripts.co/mcp` (Streamable HTTP)
- **Auth:** OAuth (sign in with Google, 30 free credits, no card) or an API key as a Bearer token
- **Registry:** [`co.bulktranscripts/youtube`](https://registry.modelcontextprotocol.io/v0/servers?search=co.bulktranscripts) · [Glama connector](https://glama.ai/mcp/connectors/co.bulktranscripts/youtube)
- **Setup docs:** https://bulktranscripts.co/docs#mcp · **REST API:** https://bulktranscripts.co/docs

## Install

### Claude Code

```bash
claude mcp add --transport http bulktranscripts https://bulktranscripts.co/mcp
```

Run `/mcp` and pick **bulktranscripts** to sign in. This repo is also a Claude Code
plugin (server + skill):

```bash
/plugin marketplace add pratie/bulktranscripts-mcp
/plugin install bulktranscripts@bulktranscripts
```

### Claude (web and desktop)

Settings → Connectors → **Add custom connector** → URL `https://bulktranscripts.co/mcp`.
Claude opens the Google sign-in; credits then follow your account.

### ChatGPT

Settings → Apps & Connectors → Developer mode → **Create** → URL
`https://bulktranscripts.co/mcp`, authentication **OAuth**.

### Gemini CLI

```bash
gemini extensions install https://github.com/pratie/bulktranscripts-mcp
```

Sign in with Google when Gemini CLI opens the OAuth page on first use.

### Cursor, VS Code, Windsurf, any client with a JSON config

```json
{
  "mcpServers": {
    "bulktranscripts": {
      "type": "http",
      "url": "https://bulktranscripts.co/mcp"
    }
  }
}
```

OAuth-capable clients start the sign-in on the first request. Clients that cannot
do OAuth send an API key instead — create one free at
https://bulktranscripts.co/app?tab=mcp (Google sign-in, 30 free credits) or use
the license key from a credit pack:

```json
{
  "mcpServers": {
    "bulktranscripts": {
      "type": "http",
      "url": "https://bulktranscripts.co/mcp",
      "headers": { "Authorization": "Bearer ${BULKTRANSCRIPTS_API_KEY}" }
    }
  }
}
```

Clients that cannot send headers can append `?key=YOUR_KEY` to the URL.

## What the agent can do

| Tool | What it does | Cost |
| --- | --- | --- |
| `get_transcript` | Full transcript of one YouTube (or TikTok) video as clean text with metadata; timestamped segments on request. | 1 credit, free on repeat reads from your library |
| `get_transcripts` | Up to 20 videos in one call; videos without captions are reported per item and never fail the batch. | 1 credit per new transcript |
| `search_youtube` | Search YouTube for videos, channels or playlists by keyword. | 1 credit |
| `search_channel` | Search inside one channel's uploads for a topic. | 1 credit |
| `get_channel_videos` | List up to 1,000 of a channel's videos (id, title, duration, URL). | 1 credit |
| `get_playlist_videos` | List up to 1,000 videos of a public or unlisted playlist, in order. | 1 credit |
| `get_latest_videos` | A channel's newest uploads with publish dates, from RSS. | **Always free** |
| `start_bulk_extract` | Fetch every transcript of a channel, playlist or video URL (up to 1,000) as a background job; returns a `run_id` at once. | Listing free, 1 credit per new transcript |
| `get_bulk_status` | Progress of a bulk job with `check_again_in_seconds`, so agents poll at the right pace. | Free |
| `list_bulk_results` | Paged per-video outcomes of a bulk job (id, title, channel, duration, word count, status). Text stays behind `get_transcript`, free once in the library. | Free |

Every tool is read-only: nothing on YouTube or in your account is modified or
deleted. Transcripts land in your library once and are free to re-read forever, in
any format, so agents that revisit the same videos do not burn credits.
`get_latest_videos` is free on purpose: poll it to detect new uploads, then spend a
credit only on what is actually new. For anything larger than about 20 videos,
`start_bulk_extract` runs the whole channel or playlist on the server while the
agent polls `get_bulk_status`.

### Example prompts

> Summarise the last 10 videos from @veritasium and tell me which ones cover quantum mechanics.

> Find talks about founder mode on the Y Combinator channel and pull the transcripts.

> Watch @simonwillison for new uploads and transcribe anything about local models.

## How auth works

An unauthenticated request to `/mcp` answers `401` with a `WWW-Authenticate` challenge
pointing at `/.well-known/oauth-protected-resource/mcp`, which is how MCP clients
know to start the OAuth flow (dynamic client registration is supported). The same
`Authorization` header accepts an API key (`bt_ak_…`) or a license key, with or
without the `Bearer ` prefix.

## Pricing

Signing in includes 30 free credits. After that, one-time packs: $4.99 / 200
credits, $14.99 / 1,200, $29 / 5,000. No subscription; credits never expire.
Details at https://bulktranscripts.co/#pricing.

## Repo layout

| File | Used by |
| --- | --- |
| `.mcp.json` | Claude Code plugin config (hosted endpoint, OAuth) |
| `.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json` | Claude Code plugin marketplace |
| `plugin.json`, `mcp.json` | Cursor / agent-plugins.org |
| `.codex-plugin/plugin.json`, `.agents/plugins/marketplace.json`, `assets/icon.png` | Codex plugin |
| `skills/youtube-transcripts/` | Agent skill for the MCP tools (the REST API version is at [pratie/youtube-transcript-skill](https://github.com/pratie/youtube-transcript-skill)) |
| `gemini-extension.json` | Gemini CLI extension (hosted endpoint, OAuth) |
| `server.json` | Official MCP registry manifest |

## Links

- Product: https://bulktranscripts.co
- MCP page: https://bulktranscripts.co/youtube-mcp-server
- API docs: https://bulktranscripts.co/docs · OpenAPI: https://bulktranscripts.co/openapi.json
- Privacy: https://bulktranscripts.co/privacy · Terms: https://bulktranscripts.co/terms
- Contact: [email protected]

## License

MIT — see [LICENSE](LICENSE). This repo holds the manifests, plugin and skill for the
hosted server; the extraction service itself is operated at bulktranscripts.co.

© BulkTranscripts · MIT · hashgraph-online/awesome-codex-plugins

Similar plugins

All plugins for Agent setup: memory, context, orchestration →

From the same set391

The whole set →
car-rental-skills car-rental-skills is a Claude Code and Codex plugin for car-rental pricing, competitor research, and business documents. A matching skill responds to each request. CX Codex ★ 1,596repo stars canvas-apps-plugin-codex canvas-apps-plugin-codex is a Codex CLI plugin that creates and edits Power Apps Canvas apps from plain-text descriptions, syncing files to an open Studio session. CX Codex ★ 1,596repo stars calle Connects the CALL-E CLI to plan, execute, and monitor automated phone calls directly from your AI coding environment. CX Codex ★ 1,596repo stars burpsuite-mcp-bridge burpsuite-mcp-bridge is a Claude Code plugin that connects Burp Suite workflows over MCP to search traffic, replay requests with bounded changes, and export evidence. CX Codex ★ 1,596repo stars build-remote-agent build-remote-agent pairs local coding sessions with a phone via the gbr-agent binary. Lets you watch terminal output and send input without opening incoming firewall ports. CX Codex ★ 1,596repo stars bkt The bkt plugin for Claude Code and Codex gives agents access to Bitbucket Cloud and Data Center repositories and pull requests, with machine-readable command output. CX Codex ★ 1,596repo stars bankbridge Wires the BankBridge remote MCP server into Claude so the agent can read your US bank, card and brokerage accounts and answer spending questions from live data. CX Codex ★ 1,596repo stars babeldoc-pdf-translate babeldoc-pdf-translate translates PDF files while preserving the original visual layout using a local BabelDOC engine, custom glossaries, and bilingual output. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open