Package Exports

scribefy-mcp
scribefy-mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (scribefy-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

scribefy-mcp

MCP server for Scribefy — extract YouTube transcripts from Claude Desktop, Cursor, Windsurf, ChatGPT custom GPTs, or any other MCP-compatible client.

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.

Requirements

Node 20+
A Scribefy account on the API + MCP plan ($25/mo). Sign up + grab a key at scribefy.app/dashboard.

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

`extract_transcript`

Pulls the transcript of a YouTube video.

Parameter	Type	Required	Description
`url`	string	yes	Full YouTube URL — `youtube.com/watch?v=…`, `youtu.be/…`, or `youtube.com/shorts/…`
`lang`	string	no	BCP-47 language code (e.g. `en`, `es`, `fr`, `zh-Hans`). Defaults to `en`

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.

Configuration

Env var	Required	Default	Notes
`SCRIBEFY_API_KEY`	yes	—	`sk_live_…` (production) or `sk_test_…` (Scribefy test mode)
`SCRIBEFY_API_BASE`	no	`https://api.scribefy.app`	Override for staging (`https://api-staging.scribefy.app`) or self-hosted instances

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