Back to Browse

Audio Transcription MCP Server

by Cykk
Developer ToolsUse Caution3.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

Transcribe local audio and video using Whisper or the OpenAI API.

About

Transcribe local audio and video using Whisper or the OpenAI API.

Security Report

3.2
Use Caution3.2High Risk

The server is a small, readable transcription wrapper with no obvious malicious code, backdoors, or hardcoded secrets. Its main concerns are that transcribe_file accepts any local path without restriction and, when an OpenAI key is present, uploads the file contents to a third-party API, so a prompt-injected or misdirected model could exfiltrate arbitrary files. The score is held below 7.0 by this unrestricted file access combined with the optional API key passed as a tool argument. Supply chain analysis found 5 known vulnerabilities in dependencies (0 critical, 5 high severity). Package verification found 1 issue.

5 files analyzed · 11 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

process_spawn

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "audio-transcription-mcp": {
      "command": "uvx",
      "args": [
        "audio-transcription-mcp==0.1.0"
      ]
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

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+
  • ffmpeg available on PATH
  • For local transcription: install the local extra of cykk-audio-transcriber
  • For OpenAI transcription: install the api extra and set OPENAI_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.

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-mcp

For 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

Reviews

No reviews yet

Be the first to review this server!