whatisgithub

What is stt-mcp?

sm18lr88/stt-mcp — explained in plain English

Analysis updated 2026-07-25

2PythonAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

In one sentence

A tool that lets AI assistants transcribe audio and video files into text entirely on your own computer, without sending media to the cloud.

Mindmap

mindmap
  root((repo))
    What it does
      Transcribes audio and video
      Runs locally for privacy
      Cleans up temp files
    Backends
      Parakeet for no GPU
      Granite for NVIDIA GPU
    Use cases
      Command line transcription
      MCP server for AI tools
      Multiple output formats
    Setup
      Needs uv and FFmpeg
      Guided setup document
      Pick backend by hardware
    Audience
      Vibe coders
      Privacy focused users
    Safety
      One task at a time
      No partial broken files
      Models only downloaded at setup

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Transcribe a meeting recording into text or Markdown on your own computer.

USE CASE 2

Generate SRT or WebVTT subtitle files from a video without using cloud services.

USE CASE 3

Let Claude Desktop or other AI tools transcribe audio files directly via an MCP server.

USE CASE 4

Transcribe audio on machines without a GPU using the Parakeet backend.

What is it built with?

PythonFFmpegMCPParakeetGranite

How does it compare?

sm18lr88/stt-mcp0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/52/52/5
Audiencevibe codergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires installing uv and FFmpeg beforehand, plus choosing the correct speech recognition backend based on your hardware.

No license is declared, so you can view the code but should not use, copy, or redistribute it until the authors add one.

So what is it?

STT-MCP is a tool that lets AI assistants transcribe audio and video files into text. It works entirely on your own computer, so your media never gets sent to a cloud service. The software takes an audio or video file, converts it into a clean format using a tool called FFmpeg, runs speech recognition to produce a written transcript, and then removes any temporary files it created along the way. There are two speech recognition engines, called backends, and the one you use depends on your hardware. Parakeet is designed for computers without dedicated graphics cards, covering Windows, Linux, and Mac systems including Apple Silicon. Granite is built for machines with a specific NVIDIA graphics card and aims for the highest quality output on that hardware. Once you pick a backend, that choice sticks for both the command line tool and the server mode. Installation is guided by a detailed setup document. The developers recommend telling your coding assistant to read that document, inspect your computer, and recommend the right backend before installing anything. You need a Python tool called uv, plus FFmpeg, installed beforehand. After setup, you can transcribe files from the command line, choosing from several output formats: plain text, Markdown, JSON, SRT subtitles, and WebVTT subtitles. You can also run it as an MCP server, which means other AI tools like Claude Desktop or Opencode can call the transcription function directly. The software is designed to be careful. It only runs one transcription at a time, so concurrent requests are rejected rather than queued. If a transcription fails, it avoids leaving behind partial or broken output files. It never downloads model files during regular operation, only during explicit setup. The project does not currently declare a license, so you should not redistribute the source until one is added. The repository also skips automated cloud testing because proper verification depends on your specific hardware, your chosen backend, and a real audio sample of someone speaking.

Copy-paste prompts

Prompt 1
Read the setup guide in this repository, inspect my computer's hardware, and tell me whether to use the Parakeet or Granite backend for STT-MCP before I install anything.
Prompt 2
Set up STT-MCP as an MCP server so I can transcribe audio files directly from Claude Desktop, and walk me through configuring the connection.
Prompt 3
Help me install uv and FFmpeg, then set up STT-MCP so I can transcribe an audio file from the command line into SRT subtitle format.
Prompt 4
Using STT-MCP, transcribe this video file and output the result as both plain text and JSON, then make sure no temporary files are left behind.

Frequently asked questions

What is stt-mcp?

A tool that lets AI assistants transcribe audio and video files into text entirely on your own computer, without sending media to the cloud.

What language is stt-mcp written in?

Mainly Python. The stack also includes Python, FFmpeg, MCP.

What license does stt-mcp use?

No license is declared, so you can view the code but should not use, copy, or redistribute it until the authors add one.

How hard is stt-mcp to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is stt-mcp for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.