Skip to content
MCP server

Audio Transcription MCP

Local MCP server that transcribes audio and video files with Whisper or OpenAI

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.1.0
Listing updated
3 days ago

About Audio Transcription MCP

Audio Transcription MCP is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

This Python package exposes one tool, transcribe_file, which takes the path of a local audio or video file and returns JSON with the detected language, the full text and timestamped segments. You can pass optional model, language, task and prompt arguments.

It runs over stdio and needs Python 3.11 or newer plus ffmpeg on your PATH. Without an API key it transcribes locally with Whisper, which may download the chosen model on first use and needs enough disk space and memory. If you set OPENAI_API_KEY it sends the audio to the OpenAI transcription API instead.

The README warns that the server reads local files, so it should only be configured in clients you trust. It is a separate project from the MP3ToText web service and does not use it.

Install

Run in a terminal

claude mcp add audio-transcription-mcp -- uvx audio-transcription-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "audio-transcription-mcp": {
      "command": "uvx",
      "args": [
        "audio-transcription-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "audio-transcription-mcp": {
      "command": "uvx",
      "args": [
        "audio-transcription-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "audio-transcription-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "audio-transcription-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

transcribe_file
Transcribes a local audio or video file and returns language, text and timestamped segments.

What it does

Local Whisper mode
Transcribes on your machine when no API key is set.
OpenAI API mode
Uses the OpenAI transcription API when OPENAI_API_KEY is provided.
Timestamped segments
Returns detected language, full text and per-segment timestamps.
Audio and video input
Accepts local audio and video files through ffmpeg.
Task and prompt options
Optional arguments for model, language, task and prompt.

Good for

  • Transcribing a recorded meeting from inside an MCP client
  • Getting timestamped text from an interview file
  • Running private transcription locally without sending audio out
  • Checking what language a recording contains

Pricing

Open source

MIT licence; OpenAI API usage is billed by OpenAI if you use that mode

Prices change. Check mp3totext.io before you buy.

Audio Transcription MCP FAQ

What does it need installed?

Python 3.11 or newer and ffmpeg on your PATH, plus the local or api extra.

Is audio sent to OpenAI?

Only if you provide an API key; otherwise Whisper runs locally.

What licence is it?

MIT.

Does it use the MP3ToText service?

No. The README says it runs independently of that product.

Is Audio Transcription MCP free?

Yes. Audio Transcription MCP is open source, so you can use and self-host it for free.

How do I add Audio Transcription MCP to Claude Code?

Run this command in your terminal: claude mcp add audio-transcription-mcp -- uvx audio-transcription-mcp

What are the best alternatives to Audio Transcription MCP?

The closest alternatives to Audio Transcription MCP are HyperFrames by HeyGen, ffmpeg-skill, Claude Code Ultimate Guide, ASTra and AvatarSay — Fictional Character & Talking Video MCP.

Alternatives to Audio Transcription MCP

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  5. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media