audiototext-mcp
Transcribe local audio/video files via an MCP server, using local Whisper by default or the OpenAI transcription API when an API key is supplied.
Call
transcribe_filewith a readable localfile_path.Optionally set
model(defaultsmall),language(defaultAuto-Detect),task(defaulttranscribe),prompt, andapi_key.Use local Whisper if no API key is provided; supply
api_keyorOPENAI_API_KEYto use OpenAI’s speech API.Get JSON output containing detected language, full transcript text, and timestamped segments.
Provides audio and video transcription through OpenAI's API, allowing local files to be transcribed with configurable model, language, task, prompt, and API key.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@audiototext-mcp transcribe /home/user/recordings/meeting.mp3 and summarize it"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Audio Transcription MCP
An MCP server for local audio and video transcription with local Whisper or the OpenAI transcription API.
Package and CLI name: audio-transcription-mcp.
Requirements
Python 3.11+
ffmpegavailable onPATHFor local transcription: install the
localextra ofcykk-audio-transcriberFor OpenAI transcription: install the
apiextra and setOPENAI_API_KEY
Install ffmpeg separately if it is not already available on your PATH.
On Debian/Ubuntu, use sudo apt install ffmpeg; on macOS with Homebrew, use
brew install ffmpeg; on Windows, install an FFmpeg build and add its bin
directory to PATH.
Related MCP server: jackai-stt-mcp
Install from source
git clone https://github.com/cykk/audio-transcription-mcp.git
cd audio-transcription-mcp
pip install ".[local]"To use the OpenAI transcription API instead:
pip install ".[api]"Install from PyPI
After the package is published to PyPI, install it directly:
pip install "audio-transcription-mcp[local]"For the OpenAI transcription API:
pip install "audio-transcription-mcp[api]"Installing without an extra does not install either transcription backend. Local Whisper may download the selected model on first use and requires sufficient disk space and memory.
Run
audio-transcription-mcpFor backward compatibility, audiototext-mcp remains available as an alias.
The server uses MCP stdio transport. Configure the command in an MCP client such as Claude Desktop, Cursor, or another compatible host:
{
"mcpServers": {
"audio-transcription": {
"command": "audio-transcription-mcp"
}
}
}Tool
transcribe_file accepts a local file_path and optional model, language, task, prompt, and api_key arguments. It returns JSON containing the detected language, full text, and timestamped segments.
The server reads local files, so only configure it in clients you trust. API keys should preferably be supplied through OPENAI_API_KEY rather than tool arguments.
With an API key, the selected audio is sent to the OpenAI API. Without one,
transcription runs locally using Whisper; the model may be downloaded on first use.
Verify
After adding the server to an MCP client, call transcribe_file with a readable local audio or video file path. A successful response contains the detected language, full transcript, and timestamped segments.
To verify the package before configuring an MCP client, run:
python -c "import asyncio; from audiototext_mcp.server import mcp; print([tool.name for tool in asyncio.run(mcp.list_tools())])"The command should include transcribe_file. A real transcription also requires
an installed local Whisper extra or a valid OPENAI_API_KEY for the API extra.
Related Product
MP3ToText is a browser-based audio and video transcription product. This MCP server runs independently and does not use the MP3ToText service.
License
MIT
Available Tools
1 tooltranscribe_fileA
Transcribe a local audio or video file and return JSON with text and timestamps.
Uses local Whisper by default. Set api_key (or OPENAI_API_KEY) to use the OpenAI speech API instead. The file must be readable by the MCP server.
Inputs: file_path (required), task, model, prompt, +2 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion. The tool's purpose is clear and distinct by default.
The single tool name 'transcribe_file' follows a clear verb_noun convention. With only one tool, there is no naming inconsistency to evaluate.
A single tool is slightly below the typical 3-15 range, but it is well-scoped for a dedicated audio-to-text server. The tool fully addresses the server's narrow purpose without unnecessary additions.
The tool covers the complete transcription workflow: accepts local audio or video files, returns transcript with timestamps, and supports both local Whisper and OpenAI API backends. There are no obvious missing operations for this domain.
Maintenance
Related MCP Connectors
Transcribes audio and video files to text, SRT, VTT and timestamped chunks for RAG.
Transcribe audio and video files to text with timestamps and SRT or WebVTT subtitles
Transcribe audio and video into speaker-labelled transcripts, subtitles, clips, and cited Q&A.
Transcribe audio & video to text for AI agents: 100+ languages, speaker labels, webhooks.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables high-quality transcription and subtitle generation from local media files or URLs using Faster Whisper on local hardware. It supports automatic language detection and integration with MCP clients for seamless speech-to-text workflows.31-

jackai-stt-mcpofficial
AlicenseAqualityDmaintenanceTranscribes audio files by referencing them in chat, using OpenAI's speech-to-text models locally without uploading audio, and supports speaker diarization.125 PyPIMIT- AlicenseNot gradedqualityCmaintenanceEnables transcription and speaker diarization of audio files, interviews, and YouTube URLs, producing speaker-attributed transcripts with timestamps. Supports multiple backends (local Whisper, OpenAI API) and output formats (txt, vtt, srt, json).Apache 2.0
- AlicenseAqualityDmaintenanceEnables MCP clients to transcribe audio/video files locally, generate SRT subtitles, and burn captions into videos via tool calls, without a cloud API.3MIT