scribefy-mcp
The scribefy-mcp server connects AI assistants to YouTube via the Model Context Protocol (MCP), enabling transcript extraction and video research workflows in clients like Claude Desktop, Cursor, or Windsurf.
Extract Transcripts (
extract_transcript): Pull the full transcript of any YouTube video (regular, Shorts, or youtu.be links) as formatted Markdown with timestamps, title, channel, duration, and language info. Supports multiple languages via BCP-47 codes (e.g.en,es,fr). Costs 1–8 credits depending on video length; cached transcripts are free.Search Videos (
search_videos): Perform free-text searches on YouTube, returning up to 25 results with title, channel, duration, view count, and URL. Free to use.Get Video Metadata (
get_video_metadata): Retrieve title, channel, duration, view count, upload date, and available caption tracks without extracting the transcript. Free to use — helpful for vetting a video before spending credits on extraction.Get Related Videos (
get_related_videos): Fetch YouTube's "Up next" / related video feed for a given video, returning up to 25 results. Free — useful for expanding research from a single starting point.
Allows extraction of YouTube transcripts and metadata, including search, video metadata, related videos, and transcript extraction with timestamps.
scribefy-mcp
MCP server for Scribefy — extract YouTube transcripts from Claude Desktop, Cursor, Windsurf, ChatGPT custom GPTs, or any other MCP-compatible client.
Live now — set it up in a minute below, or try the web app at scribefy.app.
Why
Most YouTube transcript tools live in browser extensions or one-off web UIs. This wraps Scribefy's API into the MCP standard so your AI assistant can pull a transcript whenever a user pastes a YouTube link — no manual copy-paste, no separate tabs.
Related MCP server: youtube-transcript-mcp
Requirements
Node 20+
A Scribefy account on the API + MCP plan ($25/mo) for an API key. You can install without a key first — the MCP host registers the server cleanly and you'll get a friendly nudge when you try to use a tool — then add your key from scribefy.app/dashboard to start extracting.
Setup
Claude Desktop
Open the config file (Settings → Developer → Edit Config):
{
"mcpServers": {
"scribefy": {
"command": "npx",
"args": ["-y", "scribefy-mcp"],
"env": {
"SCRIBEFY_API_KEY": "sk_live_…"
}
}
}
}Restart Claude Desktop. The extract_transcript tool appears in the available-tools panel.
Cursor
Settings → Cursor Settings → MCP → Add new MCP server:
{
"scribefy": {
"command": "npx",
"args": ["-y", "scribefy-mcp"],
"env": {
"SCRIBEFY_API_KEY": "sk_live_…"
}
}
}Windsurf
~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"scribefy": {
"command": "npx",
"args": ["-y", "scribefy-mcp"],
"env": {
"SCRIBEFY_API_KEY": "sk_live_…"
}
}
}
}Anywhere else
Any MCP host that supports stdio transport: spawn npx -y scribefy-mcp with SCRIBEFY_API_KEY in the env. The server speaks the standard MCP JSON-RPC over stdin/stdout.
Tools exposed
Four tools. Three are free (research toolkit); only extract_transcript charges credits.
extract_transcript
Pulls the transcript of a YouTube video.
Parameter | Type | Required | Description |
| string | yes | Full YouTube URL — |
| string | no | BCP-47 language code (e.g. |
Returns: Markdown with title, channel, duration, language, and the transcript split into segments with timestamps.
Cost: 1 credit (≤15 min) → 8 credits (2 h+). Cached transcripts are free.
search_videos
Free-text YouTube search.
Parameter | Type | Required | Description |
| string | yes | Search query — same syntax YouTube's own search bar accepts |
| number | no | Max results, 1–25 (default 10) |
Returns: Markdown list of title / channel / duration / views / URL for each result.
Cost: Free.
get_video_metadata
Title, channel, duration, view count, upload date, and available caption tracks. Does not pull the transcript.
Parameter | Type | Required | Description |
| string | yes | Full YouTube URL |
Returns: Markdown summary plus a list of every caption track (authored ✏ or auto-generated ⚙) with its language code.
Cost: Free. Use this to inspect a video before deciding whether to extract, or to discover which caption languages are available.
get_related_videos
YouTube's "Up next" feed for a video.
Parameter | Type | Required | Description |
| string | yes | Full YouTube URL of the seed video |
| number | no | Max related videos, 1–25 (default 10) |
Returns: Same shape as search_videos.
Cost: Free.
Tools coming in a future release
list_channel_videos and get_video_comments were planned for 0.3.0 but are deferred to 0.4.0 while we wait for upstream youtubei.js to publish fixes for YouTube's 2026 response-shape changes. Channel listing fails with HTTP 400 at the InnerTube layer, and info.getComments() is no longer attached to parsed VideoInfo. Both will return as soon as the library catches up.
Skills
The repo ships an Agent Skill (a SKILL.md your assistant loads on demand) that teaches it how to use these tools well — vet candidates with the free tools before spending credits, prefer authored captions, lean on the free transcript cache, and cite answers with timestamps.
skills/youtube-research— the YouTube research workflow: search → vet metadata → extract selectively → synthesize with[mm:ss]citations.
To use it in Claude Code, copy the folder into your project's .claude/skills/ (or ~/.claude/skills/ to have it everywhere). Open Plugins-compatible hosts detect it straight from the repo.
Configuration
Env var | Required | Default | Notes |
| yes | — |
|
| no |
| Override for staging ( |
Troubleshooting
SCRIBEFY_API_KEY is required
Make sure the env block is set in your MCP host's config and the host actually loads it. Some hosts strip env vars by default — check their docs.
Scribefy rejected the API key
Either the key is wrong, the key was revoked, or your subscription is no longer on the API + MCP plan. Check scribefy.app/dashboard.
Not enough credits
The tool returns the remaining balance and the cost in the error message. Top up at scribefy.app/pricing.
The tool doesn't show up in my MCP client
After editing the config, fully restart the client (not just the chat window). Tail the client's logs if available — most show MCP stderr there. The server prints scribefy-mcp: ready once it boots.
License
MIT
Available Tools
4 toolsextract_transcriptExtract a YouTube transcriptA
Pulls the transcript of a YouTube video and returns it as Markdown with timestamps. Use this whenever the user provides a YouTube URL and wants to summarise, quote, search, or otherwise process the video's spoken content.
Costs credits on first fetch (1 credit ≤15min, 2 credits 15–45min, 4 credits 45min–2h, 8 credits 2h+). Cached extractions are free — videos other Scribefy users have already extracted are cached for 30 days.
Returns the title, channel, duration, language, and the transcript itself split into segments with clickable timestamps.
Inputs: url (required), lang.
get_video_metadataGet metadata for a YouTube video (no transcript)A
Look up title, channel, duration, view count, upload date, and available caption tracks for a video. Does NOT pull the transcript — use extract_transcript for that. Free — no credits charged. Useful to inspect a video before deciding whether to extract, or to discover which caption languages are available.
Inputs: url (required).
search_videosSearch YouTube videos by free-text queryA
Search YouTube for videos matching a query string. Returns up to limit results (default 10, max 25) with title, channel, duration, view count, and URL. Free — no credits charged. Use this when the user asks 'find me videos about X' before chaining into extract_transcript on a specific result.
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: extracting transcripts, getting related videos, retrieving metadata, and searching. There is no overlap in functionality.
All tool names follow a consistent verb_noun pattern (e.g., extract_transcript, get_related_videos). The verbs vary but the pattern is uniform.
With 4 tools, the server is well-scoped for its purpose of YouTube video processing. The count is neither too thin nor too heavy.
The tool set covers the full workflow: search, metadata inspection, transcript extraction, and discovery of related content. No obvious gaps for the intended use case.
Maintenance
Related MCP Connectors
An MCP server that gives any LLM or agent clean YouTube transcripts on demand: a single video, a whole channel, or a playlist, plus AI cleanup of auto-generated captions. API-key auth, credit-based, same backend as the public v1 API. Get a free API key with 25 free credits at youtubetranscriptdownload.com/account.
MCP server for RiverScript, an AI transcription platform - fetches transcripts shared via a link.
Your YouTube library, in the AI tools you already use: Claude, ChatGPT, Cursor, any MCP client.
BeautySpark MCP server for ChatGPT, Claude and other MCP clients
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server designed to fetch transcripts for YouTube videos. It enables AI tools to access video text content for tasks like summarization, analysis, and key takeaway extraction.174MIT
- AlicenseAqualityCmaintenanceMCP server for YouTubeTranscript.dev — extract transcripts, manage history, and power AI assistants with YouTube content.5MIT
- AlicenseAqualityCmaintenanceMCP server for Whipscribe — transcribe audio and video from a URL or local file via Claude Desktop, Claude Code, Cursor, Windsurf, or any MCP-compatible client.61Apache 2.0
- AlicenseNot gradedqualityDmaintenanceMCP server for fetching YouTube video transcripts without an API key.GPL 3.0