io.github.blutrichPublished by GitHub account blutrichv1.1.0Updated Oct 24, 2026
Search 4M+ podcasts & YouTube, transcribe any episode, search transcripts, generate AI lessons.
PodLearn searches podcasts and YouTube, transcribes episodes, searches transcripts, and generates AI lessons from them.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.blutrich%2Fpodlearn/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"podlearn": {
"type": "http",
"url": "https://podlearn.ai/mcp"
}
}
}The podcast & video knowledge engine, right inside Claude Code. Drop a link. Get a verbatim transcript, a searchable archive, and an AI lesson in seconds.
[Claude Code plugin] [MCP included] [Free to start] [License: AGPL-3.0]
Some of the best thinking on the planet is locked inside hours of audio you'll never have time for. PodLearn unlocks it. Hand Claude any podcast or YouTube URL and it transcribes the whole thing (yes, even long talks with no captions), makes every word searchable, and distills the ideas into a structured lesson. No tab-switching, no copy-paste, no "I'll get to it later."
One install adds the PodLearn skill and MCP server to Claude Code. The skill handles the routing; the MCP does the work. You just talk.
transcribe_feed ingests an entire podcast feed in one shot, not episode-by-episode."What podcasts do you have about AI agents?" "Transcribe this and make me a lesson: ‹youtube or podcast URL›" "Find the best quotes about pricing from ‹episode›" "Transcribe the last 10 episodes of ‹podcast› and summarize the themes." "Turn that lesson into a LinkedIn post."
1. Have a PodLearn account (free, 2 credits to try) at podlearn.ai. No token needed: you sign in once in your browser.
2. Add the marketplace — in Claude Code (run this on its own, wait for confirmation):
3. Install the plugin — then run:
⚠️ Run them one at a time — they're two separate slash commands. Pasting both lines at once makes Claude treat the second as part of the first.
4. Restart Claude Code (or claude reload).
5. Sign in. Run /mcp, pick podlearn, choose Authenticate, and
approve PodLearn in the browser. Approve both read and write if you want
Claude to transcribe and save things for you (it still asks before spending
credits). Then start asking.
That's it. The plugin ships the skill and the MCP, so there's no separate
claude mcp add step and nothing to wire up by hand.
The plugin already bundles the server, so most people don't need this. But if you want the MCP on its own — in Claude Desktop, Cursor, ChatGPT, or any other MCP client, or in Claude Code without the skill — add it directly.
Claude app (web, desktop, mobile): Settings → Connectors → Add custom
connector → paste https://podlearn.ai/mcp → Connect, and sign in.
Claude Code:
Then /mcp → podlearn → Authenticate.
Codex:
Any MCP client — point it at the Streamable HTTP endpoint and sign in with OAuth:
Headless client that can't open a browser? Create a personal token in
Settings → API Tokens and send it as the
Authorization: Bearer … header. Never put it in the URL: tokens in the
query string are ignored, and calls will hang waiting for a sign-in.
Full setup guide: podlearn.ai/mcp-docs.
/mcp → podlearn → re-authenticate. To get write access after a
read-only sign-in, remove and re-add the server first./mcp. You can revoke the
old pl_mcp_… token in Settings → API Tokens.transcribe_url, transcribe_feed,
generate_lesson) spend PodLearn credits, and the skill confirms the cost
before charging. Start with 2 free credits; top up or subscribe at
podlearn.ai.PodLearn runs as a web app at podlearn.ai and as an MCP server for Claude Desktop, ChatGPT, Cursor, and any MCP-compatible client. This plugin is the fastest way to use it from Claude Code.
AGPL-3.0 — © 2026 Ofer Blutrich. Built on the PodLearn platform.
Source: README.md at commit 6950c05
Search podcasts
Search PodLearn library AND PodcastIndex.org (4M+ podcasts) by keyword. Also resolves Spotify/Apple Podcasts URLs. Returns rows tagged with `source: local|podcastindex|spotify`. First move when the user names a podcast/host but you don't have its id.
queryrequiredList podcasts
List podcasts already in the PodLearn library, optionally filtered by category. Returns most-recently-added first. For discovery beyond the library use search_podcasts.
limitoffsetcategoryPodcast details
Fetch full metadata for one podcast in the PodLearn library, including its episode count. The podcast must already be in the local DB (source=local in search_podcasts results).
podcast_idrequiredSearch episodes
Cross-podcast episode search by title/description AND parent podcast name/author. Returns local episodes only — for podcasts discoverable on PodcastIndex that aren't yet ingested, use list_feed_episodes instead. `status: "transcribed"` filters to ready-to-read; `status: "untranscribed"` to available-to-transcribe.
limitqueryrequiredoffsetstatusList feed episodes
Fetch the canonical episode list for a podcast directly from PodcastIndex (the upstream RSS index). NO COST — pure discovery. Each episode is enriched with `in_library`, `episode_id` (if already ingested), and `transcription_status`. For episodes you want to ingest: call transcribe_url(audio_url, title, feed_id, podcast_name) — passing feed_id/podcast_name lands the episode under its real show. For episodes already in_library, use start_transcription(episode_id) instead.
maxsincebeforefeed_idrequiredList episodes
List episodes already in the local DB for a specific podcast. Requires podcast_id (use search_podcasts first if you only have a name). For cross-podcast search use search_episodes; for canonical PodcastIndex listings use list_feed_episodes.
limitoffsetstatuspodcast_idrequiredEpisode details
Fetch full metadata for one episode including transcription_status and lesson_generation_status. Tells you whether get_transcription is ready or you need to transcribe first: start_transcription(episode_id) for an in-library episode (inherits its existing show/artwork/feed linkage automatically) or transcribe_url(audio_url, title, feed_id, podcast_name) for a URL not yet in the library.
episode_idrequiredTranscribe URL
Ingest and transcribe an EXTERNAL / arbitrary audio URL — a URL the user pasted, or audio not reachable through the index. Creates a STANDALONE episode row. If the episode is already in the library (it has an episode_id), prefer start_transcription(episode_id) instead — it inherits the episode's existing show, artwork, and feed linkage automatically. Consumes 1 transcription credit, or one unit of subscription quota; the credit is refunded automatically if transcription fails. Pass feed_id / podcast_name when you already know the parent show (e.g. from search_podcasts or list_feed_episodes) so the episode lands under its real show instead of appearing as unidentified "External audio". Returns the new episode_id. Transcription is asynchronous on the fallback path — poll get_episode_details until transcription_status is "completed".
titlerequiredfeed_idlanguageaudio_urlrequiredpodcast_idpodcast_nameTranscribe feed (bulk)
Bulk/season transcription — kick off transcription for up to `max` (cap 25) not-yet-transcribed episodes of a podcast feed in ONE call. Pass the `feed_id` from search_podcasts / list_feed_episodes. Already-transcribed episodes are skipped free. COSTS 1 credit per newly enqueued episode (or subscription quota) — CONFIRM the cost with the user first. Enqueue-and-poll: returns each enqueued episode_id; poll get_episode_details until transcription_status is "completed".
maxsincebeforefeed_idrequiredStart transcription
Kick off transcription on an episode ALREADY in the library. Use only when the episode row exists and transcription_status is not "completed". Inherits the episode's existing show, artwork, and feed linkage automatically — no need to pass podcast context. For audio not yet in the library, use transcribe_url. COSTS 1 CREDIT (or subscription quota).
episode_idrequiredGet transcription
Fetch transcript text for a completed episode. PAGINATED — returns up to 120,000 characters per call (Claude.ai/Desktop caps a tool result at ~150k chars). Most transcripts fit in one call; only very long episodes page. If the response has `has_more: true`, call again with `offset: <next_offset>`. For focused look-up (a topic, quote, timestamp) prefer search_transcription.
offsetmax_charsepisode_idrequiredSearch transcript
Keyword search WITHIN a single episode's transcript. Returns matching chunks with surrounding context. Use instead of get_transcription when the user asked about a specific topic — server does this faster + cheaper on context.
queryrequiredepisode_idrequiredTranscript segments
Fetch timestamped transcript segments. Use when the user wants timestamps — "jump to where they discuss X", chapter boundaries, durations of specific parts.
end_timeepisode_idrequiredstart_timeList lessons
List the calling user's saved AI-generated lessons.
limitoffsetepisode_idLesson content
Fetch the full body of one AI-generated lesson (title, summary, key takeaways, structured sections). Use to retrieve prior synthesis — for creating a NEW one call generate_lesson.
lesson_idrequiredGenerate lesson
Generate a structured AI lesson (summary, key takeaways, sections) from a completed transcription. Requires the episode to have transcription_status "completed". Consumes 1 credit, or one unit of subscription quota, on first generation for an episode; subsequent calls return the cached lesson at no cost.
episode_idrequiredSubscription status
Get the caller's subscription plan + active/expired status + period end.
Takes no parameters.
User credits
Get the caller's remaining transcription credits.
Takes no parameters.
Episode usage
Get the caller's episode-access usage stats — how many episodes they've transcribed/read this billing period.
limitoffsetSaved items
List the caller's saved/bookmarked episodes and lessons.
limitoffsetSave item
Bookmark an episode or lesson for the caller.
item_idrequireditem_typerequiredRemove saved item
Permanently remove a saved/bookmarked episode or lesson from the caller's collection. The saved_item_id comes from get_saved_items.
saved_item_idrequiredGenerate LinkedIn post
Turn an already-generated lesson into a LinkedIn-ready share post. Pass lesson_id directly OR episode_id (uses the most recent lesson generated by the caller for that episode). Lesson must exist — chain after generate_lesson if needed.
lesson_idepisode_idSearch YouTube
Discover YouTube videos by topic/keyword across all of YouTube. Use when the user wants to learn from a talk/interview/lecture and has no URL — especially when search_podcasts / search_episodes find nothing (much long-form content is YouTube-first). NO COST: pure discovery. Returns rows with a ready-to-transcribe `url`; to ingest one, confirm cost and call transcribe_url(url, title).
maxqueryrequiredBrowse episodes
Open an interactive episode picker (cards with show, title, and status) for the user to pick an episode to read. On hosts that render MCP Apps the grid is clickable; everywhere else a markdown table is returned. Optional query filters by title/host.
limitquery90% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare a license in the repository or the registry entry.
/plugin marketplace add blutrich/podlearn-plugin/plugin install podlearn@podlearnclaude mcp add --transport http podlearn https://podlearn.ai/mcpcodex mcp add podlearn --url https://podlearn.ai/mcpcodex mcp login podlearn --scopes mcp:read,mcp:write/plugin marketplace update podlearn # pull the latest/plugin uninstall podlearn@podlearn # remove the plugin/plugin marketplace remove podlearn # remove the marketplace