# justtranscribe-mcp [Health: Active]

**Category:** 🎙️ Speech-to-Text  
**Repository:** https://github.com/bramontiventures/justtranscribe-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 131  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/justtranscribe-mcp

## Description
Transcribe public videos & audio (YouTube, TikTok, IG) into accurate, timestamped text via API.

## Tools
Capabilities this server exposes over MCP:

- **transcribe_url** — start transcribing a public video/audio link (YouTube,
- **get_transcript** — poll by id; returns the full text once complete
- **list_transcripts** — the account's transcripts, newest first.
- **export_transcript** — TXT, SRT, VTT, Markdown or CSV as text.
- **delete_transcript** — permanently remove a transcript and its media.
- **get_account** — identify the key's account and limits.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "justtranscribe-mcp": {
    "command": "npx",
    "args": ["-y","justtranscribe-mcp"],
    "env": {
      "JUSTTRANSCRIBE_API_KEY": "",
      "JUSTTRANSCRIBE_API_URL": ""
    }
  }
}
```

**Requires environment variables:** `JUSTTRANSCRIBE_API_KEY`, `JUSTTRANSCRIBE_API_URL` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What justtranscribe-mcp MCP server does

The justtranscribe-mcp MCP server exposes the JustTranscribe API through MCP. It accepts public video or audio URLs and starts transcription jobs for supported sources, including YouTube, TikTok, Instagram, Facebook, Pinterest, and Google Drive. The service can automatically detect Spanish, English, and dozens of other languages.

Transcription is asynchronous. After starting a job, an agent can check its status and retrieve the completed transcript. Returned data can include the full text, timestamped segments, and the service's AI analysis for the media. The account can also be queried for its identity and applicable limits.

## How it works

The server offers two connection methods. The hosted endpoint at `https://justtranscribe.ai/api/mcp` uses Streamable HTTP and is suitable for clients that support remote MCP servers with request headers. The package runs locally with `npx justtranscribe-mcp` over stdio, which supports clients that require a local process.

Both connection methods use a JustTranscribe API key and the same account-level limits. A typical workflow calls `transcribe_url`, saves the returned transcript ID, polls with `get_transcript`, then optionally exports or deletes the result. Processing can take minutes, so clients should treat transcription as a job rather than an immediate response.

## Setup and configuration

Create an API key at `https://justtranscribe.ai/api-keys`, then provide it as `JUSTTRANSCRIBE_API_KEY`. For a local stdio connection, configure the client to run `npx -y justtranscribe-mcp` and pass the key in the process environment. The API origin can be changed with `JUSTTRANSCRIBE_API_URL`; when omitted, it defaults to `https://justtranscribe.ai`.

Claude Desktop can use the local package. Claude Code can connect either through the hosted HTTP endpoint or the local package, while Cursor is shown as a client for the hosted endpoint. The repository also includes a Claude Code plugin that runs the local MCP package and adds a `transcribe` skill. The plugin can be installed from the Claude plugins community marketplace or tested from a local clone.

## Tools and capabilities

- `transcribe_url`: starts a transcription for a public media link and returns an ID.
- `get_transcript`: polls a job and returns the completed text, with optional timestamped segments and AI analysis.
- `list_transcripts`: lists the account's transcripts with the newest entries first.
- `export_transcript`: produces TXT, SRT, VTT, Markdown, or CSV as text.
- `delete_transcript`: permanently removes a transcript and its associated media.
- `get_account`: identifies the API key's account and reports its limits.

## Limitations and notes

The justtranscribe-mcp MCP server handles public links only. Private or login-required media, live streams, and direct file uploads are not supported through MCP. Uploads must instead use the JustTranscribe app or REST API. Each recording can be up to 150 minutes long.

The service limits each key to 120 requests per minute and three new transcripts per hour. During the beta, only one transcript can process at a time. These restrictions are enforced consistently across the MCP server, application, and REST API. The package is released under the MIT license.

_Full upstream README: https://allmcps.com/mcp/justtranscribe-mcp/readme_