
Macwhisper Mcp Server
Connects Claude Desktop to MacWhisper's command-line interface for fully local audio transcription on macOS. Exposes a transcribe_audio tool that accepts file paths, optional model selection, and a persist flag to save transcripts to MacWhisper's history. Also includes list_models to see installed Whisper models, cancel_transcription for long jobs, and folder watching tools that auto-transcribe new audio files. Everything runs on your Mac with no cloud APIs. Requires MacWhisper installed with CLI enabled and an allow-list of directories configured in your Claude Desktop config. Reach for this when you want Claude to transcribe, summarize, or extract action items from audio files without sending anything off your machine.
- GitHub stars
- 3
- tools
- 7
- auth
- Required
- transport
- STDIO
- env vars
- 3
- last updated
- Oct 15, 2026
Tools
7 toolsPublic tool metadata for what this MCP can expose to an agent.
transcribe_audioTranscribe an audio file and return the transcript as plain text.
Transcribe an audio file and return the transcript as plain text.
No parameter schema in public metadata yet.
list_modelsList transcription models installed in MacWhisper, plus whisper-cpp models if MACWHISPER_WHISPERCPP_MODEL_DIR is configured; active MacWhisper model is marked
List transcription models installed in MacWhisper, plus whisper-cpp models if MACWHISPER_WHISPERCPP_MODEL_DIR is configured; active MacWhisper model is marked
No parameter schema in public metadata yet.
cancel_transcriptionCancel the currently running transcription
Cancel the currently running transcription
No parameter schema in public metadata yet.
list_allowed_pathsReturn the directories the server is allowed to read from
Return the directories the server is allowed to read from
No parameter schema in public metadata yet.
start_watchWatch a folder and auto-transcribe new audio files into ../done/
Watch a folder and auto-transcribe new audio files into ../done/
No parameter schema in public metadata yet.
stop_watchStop the active folder watcher
Stop the active folder watcher
No parameter schema in public metadata yet.
get_watch_resultsReturn completed watch-folder transcriptions and clear the queue
Return completed watch-folder transcriptions and clear the queue
No parameter schema in public metadata yet.
Sponsors
Configuration
MACWHISPER_ALLOWED_PATHS*Colon-separated list of directories the server may read audio files from (e.g. ~/Desktop:~/Downloads)
MACWHISPER_CLIPath to the mw binary. Auto-detected from /Applications/MacWhisper.app if omitted.
MACWHISPER_LOG_PATHLog file path. Defaults to ~/Library/Logs/macwhisper-mcp.log
Readme
macwhisper-mcp-server
Local MCP server that connects MacWhisper to Claude Desktop.
What it does: Drop an audio file on your Desktop, then ask Claude to transcribe it, summarise it, or pull out action items — in one step. MacWhisper does the transcription on your Mac; Claude does the thinking. Nothing leaves your machine. No cloud APIs. No data ever leaves your Mac.
Audio file → MacWhisper CLI → MCP server → Claude Desktop
Details
- Repository
- github.com/docdyhr/macwhisper-mcp-server
- Category
- Media & Entertainment
- Package
macwhisper-mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active