OpenTranscribe MCP server

OpenTranscribe MCP

<!-- mcp-name: io.github.fbossiere/open-transcribe-mcp -->

Own the recorder. Choose the intelligence.

OpenTranscribe is an open-source MCP server that routes audio to the speech-to-text model of your choice and returns one provider-independent transcript schema.

It is built around a simple idea: buying a great recorder should not lock you into one transcription subscription. Use Plaud, a phone, an open-source wearable, or any other audio source you are authorized to access, then choose Microsoft MAI, ElevenLabs Scribe, or Groq Whisper without changing the downstream workflow.

OpenTranscribe does not jailbreak hardware or bypass access controls. It works only with audio the operator is authorized to access.

How it works

OpenTranscribe keeps the integration boundary stable: the recorder supplies an audio file or HTTPS URL, the server selects or calls the requested speech-to-text provider, and downstream tools receive the same canonical transcript shape.

What v1 ships

• MCP Streamable HTTP at /mcp, with stateless operation and bearer authentication
• transcribeaudio, listtranscriptionmodels, estimatetranscriptioncost, gettranscriptchunk, and deletetranscript
• Microsoft MAI-Transcribe-2, ElevenLabs scribe-v2, and Groq Whisper adapters
• explicit capability negotiation, routing policies, retries, and observable fallbacks
• HTTPS URL passthrough when supported and a bounded streaming proxy otherwise
• SSRF controls, signed-URL redaction, zero content logging, and cost/resource limits
• disabled-by-default retention; optional memory or S3-compatible temporary result storage
• Docker, production-oriented Scaleway Serverless Containers Terraform, tests, and GitHub Actions CI

On the Linux desktop

An optional Debian package, OpenTranscribe Setup, bundles the Python runtime, the engine, and a native setup application. Install it, add a provider key, and connect a local MCP client — no Python, no uv, no configuration files. The engine then runs as one client-owned STDIO process that opens no network socket.

The hosted and command-line paths below are unaffected by it. See OpenTranscribe Setup on Linux; its release evidence lives in docs/desktop-acceptance.md, where every scenario starts at Not tested.

Ten-minute quickstart

Requirements: Python 3.12 and uv, or Docker.

git clone https://github.com/fbossiere/open-transcribe-mcp.git
cd open-transcribe-mcp
cp .env.example .env

Edit .env with one provider credential and a strong random MCP bearer token. For Microsoft:

OT_MICROSOFT__ENDPOINT=https://YOUR-RESOURCE.cognitiveservices.azure.com
OT_MICROSOFT__API_KEY=YOUR-KEY
OT_SECURITY__BEARER_TOKEN=YOUR-RANDOM-TOKEN

Start the server:

uv sync
uv run open-transcribe-mcp

Shortened. The full README is on GitHub.