Log inSubmit server
Whisper Windows MCP logo

Whisper Windows MCP

by eviscerations

Transcribes local audio and video on Windows with whisper.cpp, Vulkan GPU support, batch jobs, subtitles, and no cloud APIs.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Whisper Windows MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "eviscerations-whisper-windows-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "whisper-windows-mcp"
      ],
      "env": {
        "WHISPER_CLI_PATH": "YOUR_VALUE_HERE",
        "WHISPER_MODEL": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y whisper-windows-mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

The eviscerations/whisper-windows-mcp MCP server runs local audio and video transcription on Windows through whisper.cpp, with optional Vulkan GPU acceleration. It exposes tools for single-file transcription, background jobs, sequential folder batches, subtitle generation, media analysis, model management, and hardware checks. Audio, video, and file paths remain on the local machine because the workflow does not use cloud APIs. Reach for it when Claude Desktop needs private transcription on a Windows system with configured whisper.cpp binaries, a Whisper model, and FFmpeg.

Use cases

  • Transcribe local meeting recordings without sending media to a cloud service
  • Batch-process untranscribed files in a Windows folder
  • Generate SRT or WebVTT subtitles for video
  • Check GPU support and estimate transcription time before processing
  • Switch Whisper models for English or multilingual audio

Key features

  • Local Windows transcription with whisper.cpp
  • Vulkan GPU acceleration
  • Background jobs and sequential batch processing
  • SRT and WebVTT subtitle generation
  • Whisper model download and session switching
  • Media, configuration, and GPU diagnostics

Tools12

What Whisper Windows MCP lets your agent do. Expand a tool for its parameters.

Self-reported~582 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

96/96 checks healthy over the last 21d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · whisper-windows-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads193Package downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed12Callable tools this server registers over MCP.
Directory activity3 installs · 1 upvotesConfig copies, upvotes, and views on AllMCPs.

How Whisper Windows MCP works

What eviscerations/whisper-windows-mcp MCP server does

The eviscerations/whisper-windows-mcp MCP server connects Claude Desktop to a local Windows transcription workflow based on whisper.cpp. It can process individual audio or video files, return timestamped or plain text output, and save supported output formats beside the source media. Supported formats include text, JSON in blocking mode, SRT, WebVTT, LRC, and CSV.

The server also handles longer-running work. A single transcription can run as a background job and be checked later, while folder batches process untranscribed files sequentially. Batch processing orders files by duration, validates outputs, and advances to the next file when the current one finishes. Subtitle generation supports language detection, English translation output, SRT, and WebVTT.

How it works

Claude Desktop sends MCP tool calls to the locally installed Node.js server. The server invokes a Windows whisper.cpp executable and uses a configured Whisper model. Vulkan-enabled binaries can use AMD, NVIDIA, or Intel GPUs without a vendor-specific SDK; CPU processing is also supported through suitable models and configuration.

Before transcription, analyze_media can report file duration, size, codec, estimated CPU and GPU time, and folder-level transcription status. check_config verifies access to the whisper executable, model, and FFmpeg. check_system inspects GPU hardware, VRAM, and Vulkan support. A persistent whisper.cpp model server can keep the active model resident in VRAM for repeated transcription requests.

Setup and configuration

The eviscerations/whisper-windows-mcp MCP server requires Node.js 18 or later, whisper.cpp binaries, a Whisper model, and FFmpeg for video and non-WAV/MP3 audio. The project documents a prebuilt Vulkan Windows release or a source build using CMake, Visual Studio Build Tools, and the Vulkan SDK. The executable and supporting DLLs are expected in a local Windows directory.

Install the Node package with npm install -g whisper-windows-mcp. Claude Desktop can launch it with npx -y whisper-windows-mcp. Its MCP configuration must provide WHISPER_CLI_PATH and WHISPER_MODEL, pointing to the local whisper.cpp executable and model file. Windows paths in the JSON configuration require escaped backslashes. Restart Claude Desktop after saving the configuration, then run the configuration and hardware checks.

Models can be listed and downloaded through the MCP tools. Downloads come from trusted Hugging Face namespaces and are placed in the configured models directory. switch_model changes the active model for the current session; changing the WHISPER_MODEL setting is required for a persistent default.

Tools and capabilities

Available capabilities include:

  • Transcribe one file with language selection, timestamps, output formats, prompts, sampling controls, offsets, duration limits, word timestamps, and optional speaker-related processing.
  • Start and monitor background transcription jobs.
  • Run sequential folder batches and inspect overall progress or failed files.
  • Generate SRT or WebVTT subtitles, including English translations.
  • Inspect media metadata and estimate processing time.
  • Check configuration, GPU/Vulkan availability, installed models, and recommended model sizing.
  • Download models from Hugging Face and switch the active model.
  • Start, stop, or inspect the persistent whisper.cpp model server.

Limitations and notes

The eviscerations/whisper-windows-mcp MCP server is Windows-focused and depends on external whisper.cpp binaries. FFmpeg is required for video and for audio formats outside native WAV/MP3 handling. English-only model files cannot transcribe other languages and produce [FOREIGN] on non-English audio; multilingual models are needed for other languages.

GPU acceleration depends on Vulkan-capable hardware and the required Vulkan DLL. Model choice affects speed, memory use, and accuracy. Session-level model switching does not survive a restart. Stereo diarization requires speakers on separate channels, while mono speaker-turn detection requires a compatible tdrz model. Background jobs should be monitored with their returned job IDs, although batches advance without polling.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Whisper Windows MCP

Install Node.js 18 or later, whisper.cpp binaries, a Whisper model, and FFmpeg as needed, then run `npx -y whisper-windows-mcp` or install the package globally with npm.

Yes. The documented setup adds the server to Claude Desktop's MCP configuration and launches it with `npx -y whisper-windows-mcp`.

No.

The documented Claude Desktop configuration sets `WHISPER_CLI_PATH` for the whisper.cpp executable and `WHISPER_MODEL` for the active model file.

Yes. It can generate SRT or WebVTT subtitles, including automatic language detection and English translation output.

Related MCP servers

All in Speech-to-Text All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewWhisper Windows MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/eviscerations-whisper-windows-mcp?style=directory)](https://allmcps.com/mcp/eviscerations-whisper-windows-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/eviscerations-whisper-windows-mcp"><img src="https://allmcps.com/api/badge/eviscerations-whisper-windows-mcp?style=directory" alt="Whisper Windows MCP on AllMCPs" /></a>