# Whipscribe MCP

> Whipscribe MCP is a freemium MCP server for design and media. Transcribe audio and video from files or links through the WhipScribe cloud API. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $19 a month
- **Platforms:** CLI, API, Web
- **Website:** https://whipscribe.com
- **Repository:** https://github.com/neugence/whipscribe-mcp
- **MCP Registry name:** io.github.neugence/whipscribe-mcp
- **Categories:** design and media, files and documents
- **Listing updated:** 2026-11-16

## About

This is a local stdio package, installed with uvx or pip, that sends recordings to WhipScribe's hosted transcription service and returns the text. It accepts a local file or any URL such as YouTube, podcast feeds or direct links. Each job returns a JSON result with a status, a 300-character preview and a link to the full transcript, and transcripts can be fetched as txt, json, srt, vtt or docx.

The tools can request speaker labels and word timestamps, set a language, and poll a running job. Without an API key every recording still gets a free preview; a key links jobs to your account and credits. The README labels the service as beta: endpoints, quotas and credits can change, jobs may fail or return partial output, and it is not suited to cases where a failed transcript has legal, safety or financial consequences.

The website says audio is transcribed on its own servers and not used for training. Pricing there is in minute packs from $4 that never expire, plus a $19 a month Workspace plan. The package also sends anonymous telemetry unless WHIPSCRIBE_MCP_TELEMETRY is set to 0.

## Features

- **URL transcription:** Transcribe audio or video from YouTube, podcast feeds and direct links.
- **Local file transcription:** Upload and transcribe a file from disk.
- **Speaker and timestamp options:** Optional diarization and word-level timestamps.
- **Multiple export formats:** Fetch transcripts as txt, json, srt, vtt or docx.
- **Job tracking:** Check job status and list recent jobs.
- **Optional API key:** Free preview without a key; a key unlocks paid quota.

## Good for

- Transcribe a podcast episode from its URL
- Get subtitles in SRT or VTT for a video
- Transcribe a recorded interview with speaker labels
- Pull a transcript into an assistant for summarising

## Install

### Claude Code (Terminal)

```sh
claude mcp add whipscribe-mcp --env WHIPSCRIBE_API_KEY='<WHIPSCRIBE_API_KEY>' -- uvx whipscribe-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "whipscribe-mcp": {
      "command": "uvx",
      "args": [
        "whipscribe-mcp"
      ],
      "env": {
        "WHIPSCRIBE_API_KEY": "<WHIPSCRIBE_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "whipscribe-mcp": {
      "command": "uvx",
      "args": [
        "whipscribe-mcp"
      ],
      "env": {
        "WHIPSCRIBE_API_KEY": "<WHIPSCRIBE_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "whipscribe-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "whipscribe-mcp"
      ],
      "env": {
        "WHIPSCRIBE_API_KEY": "<WHIPSCRIBE_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "whipscribe-mcp": {
      "command": "uvx",
      "args": [
        "whipscribe-mcp"
      ],
      "env": {
        "WHIPSCRIBE_API_KEY": "<WHIPSCRIBE_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "whipscribe-mcp": {
      "command": "uvx",
      "args": [
        "whipscribe-mcp"
      ],
      "env": {
        "WHIPSCRIBE_API_KEY": "<WHIPSCRIBE_API_KEY>"
      }
    }
  }
}
```

## Tools

- `transcribe_url`: Transcribes audio or video from a URL.
- `transcribe_file`: Transcribes a local audio or video file.
- `get_job_status`: Checks progress of a running job.
- `get_transcript`: Fetches a transcript in txt, json, srt, vtt or docx.
- `list_recent_jobs`: Lists recent jobs from a local cache.

## FAQ

### Do I need an API key?

No. The anonymous free tier works without a key, and a key unlocks paid quota.

### What formats can I download?

txt, json, srt, vtt and docx.

### Is it production ready?

The README calls it a beta and warns against use where transcription failure has legal, safety or financial consequences.

### Does the package collect data?

Anonymous telemetry covers tool name, duration and error code, not URLs, paths or transcripts, and can be disabled with WHIPSCRIBE_MCP_TELEMETRY=0.

### Is Whipscribe MCP free?

Whipscribe MCP has a free plan, with paid plans for more usage or features. Paid plans start at $19 a month.

### How do I add Whipscribe MCP to Claude Code?

Run this command in your terminal: claude mcp add whipscribe-mcp --env WHIPSCRIBE_API_KEY='<WHIPSCRIBE_API_KEY>' -- uvx whipscribe-mcp

### What are the best alternatives to Whipscribe MCP?

The closest alternatives to Whipscribe MCP are HyperFrames by HeyGen, ffmpeg-skill, ASTra, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/whipscribe-mcp
